deepblue/windows-itpro-docs
1
0
Fork 0
mirror of https://github.com/MicrosoftDocs/windows-itpro-docs.git synced 2025-05-12 21:37:22 +00:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

Added new content for RS5

Browse Source
This commit is contained in:
MariciaAlforque 2018-08-28 11:40:26 -07:00
parent d721386234
commit 8c32505148
3 changed files with 246 additions and 55 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

BIN
windows/client-management/mdm/images/provisioning-csp-uefi.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 12 KiB

After

Width:  |  Height:  |  Size: 22 KiB

54
windows/client-management/mdm/uefi-csp.md
View File

@ -12,7 +12,10 @@ ms.date: 02/01/2018
# UEFI CSP # UEFI CSP
The UEFI configuration service provider (CSP) interfaces to UEFI's Device Firmware Configuration Interface (DFCI) to make BIOS configuration changes. This CSP was added in Windows 10, version 1803. The UEFI configuration service provider (CSP) interfaces to UEFI's Device Firmware Configuration Interface (DFCI) to make BIOS configuration changes. This CSP was added in Windows 10, next major version.
> [!Note]
> The UEFI CSP version published in Windows 10, version 1803 was replaced with this entirely different version.
The following diagram shows the UEFI CSP in tree format. The following diagram shows the UEFI CSP in tree format.
@ -23,45 +26,46 @@ The following list describes the characteristics and parameters.
<a href="" id="uefi"></a>**./Vendor/MSFT/Uefi** <a href="" id="uefi"></a>**./Vendor/MSFT/Uefi**
Root node. Root node.
<a href="" id="uefideviceidentifier"></a>**UefiDeviceIdentifier** <a href="" id="deviceidentifier"></a>**DeviceIdentifier**
Retrieves XML from UEFI which describes the device identifier. Retrieves XML from UEFI that describes the device identifier.
Supported operation is Get. Supported operation is Get.
<a href="" id="identityinfo"></a>**IdentityInfo** <a href="" id="identity"></a>**Identity**
Node for provisioned signers operations. Node for identity certificate operations.
<a href="" id="identityinfo-current"></a>**IdentityInfo/Current**
Retrieves XML from UEFI which describes the current UEFI identity information.
Supported operation is Get. Supported operation is Get.
<a href="" id="identityinfo-apply"></a>**IdentityInfo/Apply** <a href="" id="identity-current"></a>**Identity/Current**
Apply an identity information package to UEFI. Input is the signed package in base64 encoded format. Retrieves XML from UEFI that describes the current UEFI identity certificate information.
Supported operation is Replace.
<a href="" id="identityinfo-applyresult"></a>**IdentityInfo/ApplyResult**
Retrieves XML describing the results of previous ApplyIdentityInfo operation.
Supported operation is Get. Supported operation is Get.
<a href="" id="authinfo"></a>**AuthInfo** <a href="" id="identity-apply"></a>**Identity/Apply**
Node for permission information operations. Applies an identity information package to UEFI. Input is the signed package in base64 encoded format.
<a href="" id="authinfo-current"></a>**AuthInfo/Current** Value type is Base64. Supported operation is Replace.
Retrieves XML from UEFI which describes the current UEFI permission/authentication information.
<a href="" id="identity-result"></a>**Identity/Result**
Retrieves the binary result package of the previous Identity/Apply operation.
Supported operation is Get. Supported operation is Get.
<a href="" id="authinfo-apply"></a>**AuthInfo/Apply** <a href="" id="permissions"></a>**Permissions**
Apply a permission/authentication information package to UEFI. Input is the signed package in base64 encoded format. Node for settings permission operations..
Supported operation is Replace. <a href="" id="permissions-current"></a>**Permissions/Current**
Retrieves XML from UEFI which describes the current UEFI settings permissions.
<a href="" id="authinfo-applyresult"></a>**AuthInfo/ApplyResult** Supported operation is Get.
Retrieves XML describing the results of previous ApplyAuthInfo operation.
<a href="" id="permissions-apply"></a>**Permissions/Apply**
Apply a permissions information package to UEFI. Input is the signed package in base64 encoded format.
Value type is Base64. Supported operation is Replace.
<a href="" id="permissions-result"></a>**Permissions/Result**
Retrieves the binary result package of the previous Permissions/Apply operation. This binary package contains XML describing the action taken for each individual permission.
Supported operation is Get. Supported operation is Get.

247
windows/client-management/mdm/uefi-ddf.md
View File

@ -6,7 +6,7 @@ ms.topic: article
ms.prod: w10 ms.prod: w10
ms.technology: windows ms.technology: windows
author: MariciaAlforque author: MariciaAlforque
ms.date: 02/01/2018 ms.date: 08/28/2018
--- ---
# UEFI DDF file # UEFI DDF file
@ -16,7 +16,7 @@ This topic shows the OMA DM device description framework (DDF) for the **Uefi**
Looking for the DDF XML files? See [CSP DDF files download](configuration-service-provider-reference.md#csp-ddf-files-download). Looking for the DDF XML files? See [CSP DDF files download](configuration-service-provider-reference.md#csp-ddf-files-download).
The XML below is the current version for this CSP. The XML below is for Windows 10, next major version.
``` syntax ``` syntax
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
@ -32,6 +32,7 @@ The XML below is the current version for this CSP.
<AccessType> <AccessType>
<Get /> <Get />
</AccessType> </AccessType>
<Description>UEFI Firmware Configuration Service Provider.</Description>
<DFFormat> <DFFormat>
<node /> <node />
</DFFormat> </DFFormat>
@ -46,12 +47,12 @@ The XML below is the current version for this CSP.
</DFType> </DFType>
</DFProperties> </DFProperties>
<Node> <Node>
<NodeName>UefiDeviceIdentifier</NodeName> <NodeName>DeviceIdentifier</NodeName>
<DFProperties> <DFProperties>
<AccessType> <AccessType>
<Get /> <Get />
</AccessType> </AccessType>
<Description>Retrieves XML from UEFI which describes the device identifier.</Description> <Description>Retrieves XML from UEFI which contains the device identifier.</Description>
<DFFormat> <DFFormat>
<xml /> <xml />
</DFFormat> </DFFormat>
@ -61,21 +62,18 @@ The XML below is the current version for this CSP.
<Scope> <Scope>
<Permanent /> <Permanent />
</Scope> </Scope>
<CaseSense>
<CIS />
</CaseSense>
<DFType> <DFType>
<MIME>text/plain</MIME> <MIME>text/plain</MIME>
</DFType> </DFType>
</DFProperties> </DFProperties>
</Node> </Node>
<Node> <Node>
<NodeName>IdentityInfo</NodeName> <NodeName>Identity</NodeName>
<DFProperties> <DFProperties>
<AccessType> <AccessType>
<Get /> <Get />
</AccessType> </AccessType>
<Description>Provisioned signers</Description> <Description>Identity certificate operations.</Description>
<DFFormat> <DFFormat>
<node /> <node />
</DFFormat> </DFFormat>
@ -95,7 +93,7 @@ The XML below is the current version for this CSP.
<AccessType> <AccessType>
<Get /> <Get />
</AccessType> </AccessType>
<Description>Retrieves XML from UEFI which describes the current UEFI identity information</Description> <Description>Retrieves XML from UEFI which describes the current UEFI identity certificate information.</Description>
<DFFormat> <DFFormat>
<xml /> <xml />
</DFFormat> </DFFormat>
@ -132,14 +130,14 @@ The XML below is the current version for this CSP.
</DFProperties> </DFProperties>
</Node> </Node>
<Node> <Node>
<NodeName>ApplyResult</NodeName> <NodeName>Result</NodeName>
<DFProperties> <DFProperties>
<AccessType> <AccessType>
<Get /> <Get />
</AccessType> </AccessType>
<Description>Retrieves XML describing the results of previous ApplyIdentityInfo operation.</Description> <Description>Retrieves the binary result package of the previous Identity/Apply operation.</Description>
<DFFormat> <DFFormat>
<xml /> <b64 />
</DFFormat> </DFFormat>
<Occurrence> <Occurrence>
<One /> <One />
@ -148,18 +146,18 @@ The XML below is the current version for this CSP.
<Permanent /> <Permanent />
</Scope> </Scope>
<DFType> <DFType>
<MIME>text/plain</MIME> <DDFName></DDFName>
</DFType> </DFType>
</DFProperties> </DFProperties>
</Node> </Node>
</Node> </Node>
<Node> <Node>
<NodeName>AuthInfo</NodeName> <NodeName>Permissions</NodeName>
<DFProperties> <DFProperties>
<AccessType> <AccessType>
<Get /> <Get />
</AccessType> </AccessType>
<Description>Permission Information</Description> <Description>Settings permission operations.</Description>
<DFFormat> <DFFormat>
<node /> <node />
</DFFormat> </DFFormat>
@ -179,7 +177,7 @@ The XML below is the current version for this CSP.
<AccessType> <AccessType>
<Get /> <Get />
</AccessType> </AccessType>
<Description>Retrieves XML from UEFI which describes the current UEFI permission/authentication information.</Description> <Description>Retrieves XML from UEFI which describes the current UEFI settings permissions.</Description>
<DFFormat> <DFFormat>
<xml /> <xml />
</DFFormat> </DFFormat>
@ -200,7 +198,7 @@ The XML below is the current version for this CSP.
<AccessType> <AccessType>
<Replace /> <Replace />
</AccessType> </AccessType>
<Description>Apply a permission/authentication information package to UEFI. Input is the signed package in base64 encoded format.</Description> <Description>Apply a permissions information package to UEFI. Input is the signed package in base64 encoded format.</Description>
<DFFormat> <DFFormat>
<b64 /> <b64 />
</DFFormat> </DFFormat>
@ -216,14 +214,14 @@ The XML below is the current version for this CSP.
</DFProperties> </DFProperties>
</Node> </Node>
<Node> <Node>
<NodeName>ApplyResult</NodeName> <NodeName>Result</NodeName>
<DFProperties> <DFProperties>
<AccessType> <AccessType>
<Get /> <Get />
</AccessType> </AccessType>
<Description>Retrieves XML describing the results of previous ApplyAuthInfo operation.</Description> <Description>Retrieves the binary result package of the previous Permissions/Apply operation. This binary package contains XML describing the action taken for each individual permission.</Description>
<DFFormat> <DFFormat>
<xml /> <b64 />
</DFFormat> </DFFormat>
<Occurrence> <Occurrence>
<One /> <One />
@ -232,18 +230,18 @@ The XML below is the current version for this CSP.
<Permanent /> <Permanent />
</Scope> </Scope>
<DFType> <DFType>
<MIME>text/plain</MIME> <DDFName></DDFName>
</DFType> </DFType>
</DFProperties> </DFProperties>
</Node> </Node>
</Node> </Node>
<Node> <Node>
<NodeName>Config</NodeName> <NodeName>Settings</NodeName>
<DFProperties> <DFProperties>
<AccessType> <AccessType>
<Get /> <Get />
</AccessType> </AccessType>
<Description>Device Configuration</Description> <Description>Device settings operations.</Description>
<DFFormat> <DFFormat>
<node /> <node />
</DFFormat> </DFFormat>
@ -263,7 +261,7 @@ The XML below is the current version for this CSP.
<AccessType> <AccessType>
<Get /> <Get />
</AccessType> </AccessType>
<Description>Retrieves XML from UEFI which describes the current UEFI configuration.</Description> <Description>Retrieves XML from UEFI which describes the current UEFI settings.</Description>
<DFFormat> <DFFormat>
<xml /> <xml />
</DFFormat> </DFFormat>
@ -284,7 +282,7 @@ The XML below is the current version for this CSP.
<AccessType> <AccessType>
<Replace /> <Replace />
</AccessType> </AccessType>
<Description>Apply a configuration package to UEFI. Input is the signed package in base64 encoded format.</Description> <Description>Apply a settings information package to UEFI. Input is the signed package in base64 encoded format.</Description>
<DFFormat> <DFFormat>
<b64 /> <b64 />
</DFFormat> </DFFormat>
@ -300,14 +298,14 @@ The XML below is the current version for this CSP.
</DFProperties> </DFProperties>
</Node> </Node>
<Node> <Node>
<NodeName>ApplyResult</NodeName> <NodeName>Result</NodeName>
<DFProperties> <DFProperties>
<AccessType> <AccessType>
<Get /> <Get />
</AccessType> </AccessType>
<Description>Retrieves XML describing the results of previous ApplyConfig operation.</Description> <Description>Retrieves the binary result package of the previous Settings/Apply operation. This binary package contains XML describing the action taken for each individual setting.</Description>
<DFFormat> <DFFormat>
<xml /> <b64 />
</DFFormat> </DFFormat>
<Occurrence> <Occurrence>
<One /> <One />
@ -316,7 +314,196 @@ The XML below is the current version for this CSP.
<Permanent /> <Permanent />
</Scope> </Scope>
<DFType> <DFType>
<MIME>text/plain</MIME> <DDFName></DDFName>
</DFType>
</DFProperties>
</Node>
</Node>
<Node>
<NodeName>Identity2</NodeName>
<DFProperties>
<AccessType>
<Get />
</AccessType>
<Description>Identity certificate operations. Alternate endpoint for sending a second identity package without an OS restart.</Description>
<DFFormat>
<node />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<DDFName></DDFName>
</DFType>
</DFProperties>
<Node>
<NodeName>Apply</NodeName>
<DFProperties>
<AccessType>
<Replace />
</AccessType>
<Description>Apply an identity information package to UEFI. Input is the signed package in base64 encoded format. Alternate location for sending two identity packages in the same session.</Description>
<DFFormat>
<b64 />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<DDFName></DDFName>
</DFType>
</DFProperties>
</Node>
<Node>
<NodeName>Result</NodeName>
<DFProperties>
<AccessType>
<Get />
</AccessType>
<Description>Retrieves the binary result package of the previous Identity2/Apply operation.</Description>
<DFFormat>
<b64 />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<DDFName></DDFName>
</DFType>
</DFProperties>
</Node>
</Node>
<Node>
<NodeName>Permissions2</NodeName>
<DFProperties>
<AccessType>
<Get />
</AccessType>
<Description>Settings permission operations. Alternate endpoint for sending a second permission package without an OS restart.</Description>
<DFFormat>
<node />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<DDFName></DDFName>
</DFType>
</DFProperties>
<Node>
<NodeName>Apply</NodeName>
<DFProperties>
<AccessType>
<Replace />
</AccessType>
<Description>Apply a permissions information package to UEFI. Input is the signed package in base64 encoded format. Alternate location for sending two permissions information packages in the same session.</Description>
<DFFormat>
<b64 />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<DDFName></DDFName>
</DFType>
</DFProperties>
</Node>
<Node>
<NodeName>Result</NodeName>
<DFProperties>
<AccessType>
<Get />
</AccessType>
<Description>Retrieves the binary result package from the previous Permissions2/Apply operation. This binary package contains XML describing the action taken for each individual permission.</Description>
<DFFormat>
<b64 />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<DDFName></DDFName>
</DFType>
</DFProperties>
</Node>
</Node>
<Node>
<NodeName>Settings2</NodeName>
<DFProperties>
<AccessType>
<Get />
</AccessType>
<Description>Device settings operations. Alternate endpoint for sending a second settings package without an OS restart.</Description>
<DFFormat>
<node />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<DDFName></DDFName>
</DFType>
</DFProperties>
<Node>
<NodeName>Apply</NodeName>
<DFProperties>
<AccessType>
<Replace />
</AccessType>
<Description>Apply a settings information package to UEFI. Input is the signed package in base64 encoded format. Alternate location for sending two settings information packages in the same session.</Description>
<DFFormat>
<b64 />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<DDFName></DDFName>
</DFType>
</DFProperties>
</Node>
<Node>
<NodeName>Result</NodeName>
<DFProperties>
<AccessType>
<Get />
</AccessType>
<Description>Retrieves the binary result package of previous Settings2/Apply operation. This binary package contains XML describing the action taken for each individual setting.</Description>
<DFFormat>
<b64 />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<DDFName></DDFName>
</DFType> </DFType>
</DFProperties> </DFProperties>
</Node> </Node>