diff --git a/windows/client-management/mdm/devicestatus-csp.md b/windows/client-management/mdm/devicestatus-csp.md index 9abf518c45..3ed0ffade4 100644 --- a/windows/client-management/mdm/devicestatus-csp.md +++ b/windows/client-management/mdm/devicestatus-csp.md @@ -12,6 +12,8 @@ ms.date: 06/19/2017 # DeviceStatus CSP +> [!WARNING] +> Some information relates to prereleased product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here. The DeviceStatus configuration service provider is used by the enterprise to keep track of device inventory and query the state of compliance of these devices with their enterprise policies. @@ -113,32 +115,32 @@ Boolean value that indicates compliance with the enterprise encryption policy. T Supported operation is Get. **DeviceStatus/TPM** -Added in , version 1607. Node for the TPM query. +Added in Windows, version 1607. Node for the TPM query. Supported operation is Get. **DeviceStatus/TPM/SpecificationVersion** -Added in , version 1607. String that specifies the specification version. +Added in Windows, version 1607. String that specifies the specification version. Supported operation is Get. **DeviceStatus/OS** -Added in , version 1607. Node for the OS query. +Added in Windows, version 1607. Node for the OS query. Supported operation is Get. **DeviceStatus/OS/Edition** -Added in , version 1607. String that specifies the OS edition. +Added in Windows, version 1607. String that specifies the OS edition. Supported operation is Get. **DeviceStatus/Antivirus** -Added in , version 1607. Node for the antivirus query. +Added in Windows, version 1607. Node for the antivirus query. Supported operation is Get. **DeviceStatus/Antivirus/SignatureStatus** -Added in , version 1607. Integer that specifies the status of the antivirus signature. +Added in Windows, version 1607. Integer that specifies the status of the antivirus signature. Valid values: @@ -149,7 +151,7 @@ Valid values: Supported operation is Get. **DeviceStatus/Antivirus/Status** -Added in , version 1607. Integer that specifies the status of the antivirus. +Added in Windows, version 1607. Integer that specifies the status of the antivirus. Valid values: @@ -162,27 +164,27 @@ Valid values: Supported operation is Get. **DeviceStatus/Antispyware** -Added in , version 1607. Node for the antispyware query. +Added in Windows, version 1607. Node for the antispyware query. Supported operation is Get. **DeviceStatus/Antispyware/SignatureStatus** -Added in , version 1607. Integer that specifies the status of the antispyware signature. +Added in Windows, version 1607. Integer that specifies the status of the antispyware signature. Supported operation is Get. **DeviceStatus/Antispyware/Status** -Added in , version 1607. Integer that specifies the status of the antispyware. +Added in Windows, version 1607. Integer that specifies the status of the antispyware. Supported operation is Get. **DeviceStatus/Firewall** -Added in , version 1607. Node for the firewall query. +Added in Windows, version 1607. Node for the firewall query. Supported operation is Get. **DeviceStatus/Firewall/Status** -Added in , version 1607. Integer that specifies the status of the firewall. +Added in Windows, version 1607. Integer that specifies the status of the firewall. Valid values: @@ -195,43 +197,84 @@ Valid values: Supported operation is Get. **DeviceStatus/UAC** -Added in , version 1607. Node for the UAC query. +Added in Windows, version 1607. Node for the UAC query. Supported operation is Get. **DeviceStatus/UAC/Status** -Added in , version 1607. Integer that specifies the status of the UAC. +Added in Windows, version 1607. Integer that specifies the status of the UAC. Supported operation is Get. **DeviceStatus/Battery** -Added in , version 1607. Node for the battery query. +Added in Windows, version 1607. Node for the battery query. Supported operation is Get. **DeviceStatus/Battery/Status** -Added in , version 1607. Integer that specifies the status of the battery +Added in Windows, version 1607. Integer that specifies the status of the battery Supported operation is Get. **DeviceStatus/Battery/EstimatedChargeRemaining** -Added in , version 1607. Integer that specifies the estimated battery charge remaining. This is the value returned in **BatteryLifeTime** in [SYSTEM\_POWER\_STATUS structure](https://msdn.microsoft.com/library/windows/desktop/aa373232.aspx). +Added in Windows, version 1607. Integer that specifies the estimated battery charge remaining. This is the value returned in **BatteryLifeTime** in [SYSTEM\_POWER\_STATUS structure](https://msdn.microsoft.com/library/windows/desktop/aa373232.aspx). The value is the number of seconds of battery life remaining when the device is not connected to an AC power source. When it is connected to a power source, the value is -1. When the estimation is unknown, the value is -1. Supported operation is Get. **DeviceStatus/Battery/EstimatedRuntime** -Added in , version 1607. Integer that specifies the estimated runtime of the battery. This is the value returned in **BatteryLifeTime** in [SYSTEM\_POWER\_STATUS structure](https://msdn.microsoft.com/library/windows/desktop/aa373232.aspx). +Added in Windows, version 1607. Integer that specifies the estimated runtime of the battery. This is the value returned in **BatteryLifeTime** in [SYSTEM\_POWER\_STATUS structure](https://msdn.microsoft.com/library/windows/desktop/aa373232.aspx). The value is the number of seconds of battery life remaining when the device is not connected to an AC power source. When it is connected to a power source, the value is -1. When the estimation is unknown, the value is -1. Supported operation is Get. -  - -  +**DeviceStatus/DomainName** +Added in Windows, version 1709. Returns the fully qualified domain name of the device (if any). +Supported operation is Get. + +**DeviceStatus/DeviceGuard** +Added in Windows, version 1709. Node for Device Guard query. + +Supported operation is Get. + +**DeviceStatus/DeviceGuard/VirtualizationBasedSecurityHwReq** +Added in Windows, version 1709. Virtualization-based security hardware requirement status. The value is a 256 value bitmask. + +- 0x0: System meets hardware configuration requirements +- 0x1: SecureBoot required +- 0x2: DMA Protection required +- 0x4: HyperV not supported for Guest VM +- 0x8: HyperV feature is not available + +Supported operation is Get. + +**DeviceStatus/DeviceGuard/VirtualizationBasedSecurityStatus** +Added in Windows, version 1709. Virtualization-based security status. Value is one of the following: +- 0 - Running +- 1 - Reboot required +- 2 - 64 bit architecture required +- 3 - not licensed +- 4 - not configured +- 5 - System doesn't meet hardware requirements +- 42 – Other. Event logs in Microsoft-Windows-DeviceGuard have more details + + +Supported operation is Get. + +**DeviceStatus/DeviceGuard/LsaCfgCredGuardStatus** +Added in Windows, version 1709. Local System Authority (LSA) credential guard status. + +- 0 - Running +- 1 - Reboot required +- 2 - Not licensed for Credential Guard +- 3 - Not configured +- 4 - VBS not running + + +Supported operation is Get. diff --git a/windows/client-management/mdm/devicestatus-ddf.md b/windows/client-management/mdm/devicestatus-ddf.md index 9fc150cf5b..b9e8608716 100644 --- a/windows/client-management/mdm/devicestatus-ddf.md +++ b/windows/client-management/mdm/devicestatus-ddf.md @@ -7,11 +7,13 @@ ms.topic: article ms.prod: w10 ms.technology: windows author: nickbrower -ms.date: 06/19/2017 +ms.date: 07/24/2017 --- # DeviceStatus DDF +> [!WARNING] +> Some information relates to prereleased product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here. This topic shows the OMA DM device description framework (DDF) for the **DeviceStatus** configuration service provider. DDF files are used only with OMA DM provisioning XML. @@ -20,7 +22,7 @@ You can download the DDF files from the links below: - [Download all the DDF files for Windows 10, version 1703](http://download.microsoft.com/download/C/7/C/C7C94663-44CF-4221-ABCA-BC895F42B6C2/Windows10_1703_DDF_download.zip) - [Download all the DDF files for Windows 10, version 1607](http://download.microsoft.com/download/2/3/E/23E27D6B-6E23-4833-B143-915EDA3BDD44/Windows10_1607_DDF.zip) -The XML below is the current version for this CSP. +The XML below is for Windows 10, version 1709. ``` syntax @@ -46,7 +48,7 @@ The XML below is the current version for this CSP. - com.microsoft/1.2/MDM/DeviceStatus + com.microsoft/1.4/MDM/DeviceStatus @@ -761,16 +763,108 @@ The XML below is the current version for this CSP. + + DomainName + + + + + Returns the fully qualified domain name of the device(if any). + + + + + + + + + + DomainName + + text/plain + + + + + DeviceGuard + + + + + + + + + + + + + + + + + + + VirtualizationBasedSecurityHwReq + + + + + + + + + + + + + + + text/plain + + + + + VirtualizationBasedSecurityStatus + + + + + + + + + + + + + + + text/plain + + + + + LsaCfgCredGuardStatus + + + + + + + + + + + + + + + text/plain + + + + -``` - -  - -  - - - - - - +``` \ No newline at end of file diff --git a/windows/client-management/mdm/images/provisioning-csp-devicestatus.png b/windows/client-management/mdm/images/provisioning-csp-devicestatus.png index 55b12f6c7f..a533d0f559 100644 Binary files a/windows/client-management/mdm/images/provisioning-csp-devicestatus.png and b/windows/client-management/mdm/images/provisioning-csp-devicestatus.png differ diff --git a/windows/client-management/mdm/new-in-windows-mdm-enrollment-management.md b/windows/client-management/mdm/new-in-windows-mdm-enrollment-management.md index cc9ac9b98a..dffaa28270 100644 --- a/windows/client-management/mdm/new-in-windows-mdm-enrollment-management.md +++ b/windows/client-management/mdm/new-in-windows-mdm-enrollment-management.md @@ -949,6 +949,15 @@ For details about Microsoft mobile device management protocols for Windows 10 s

Added DeviceTunnel profile in Windows 10, version 1709.

+[DeviceStatus CSP](devicestatus-csp.md) +

Added the following settings in Windows 10, version 1709:

+ + +[DeviceStatus CSP](devicestatus-csp.md) +

Added the following settings in Windows 10, version 1709:

+