WiredNetwork CSP

This commit is contained in:
Vinay Pamnani 2023-02-16 17:23:39 -05:00
parent dfa557be8c
commit c0ef7b0b35
2 changed files with 355 additions and 202 deletions

View File

@ -1,70 +1,203 @@
--- ---
title: WiredNetwork CSP title: WiredNetwork CSP
description: The WiredNetwork configuration service provider (CSP) is used by the enterprise to configure wired Internet on devices that don't have GP. Learn how it works. description: Learn more about the WiredNetwork CSP.
author: vinaypamnani-msft
manager: aaroncz
ms.author: vinpa ms.author: vinpa
ms.topic: article ms.date: 02/16/2023
ms.localizationpriority: medium
ms.prod: windows-client ms.prod: windows-client
ms.technology: itpro-manage ms.technology: itpro-manage
author: vinaypamnani-msft ms.topic: reference
ms.date: 06/27/2018
ms.reviewer:
manager: aaroncz
--- ---
<!-- Auto-Generated CSP Document -->
<!-- WiredNetwork-Begin -->
# WiredNetwork CSP # WiredNetwork CSP
The table below shows the applicability of Windows: <!-- WiredNetwork-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
|Edition|Windows 10|Windows 11| The WiredNetwork configuration service provider (CSP) is used by the enterprise to configure wired Internet on devices that don't have group policy to enable them to access corporate Internet over ethernet.
|--- |--- |--- | <!-- WiredNetwork-Editable-End -->
|Home|No|No|
|Pro|Yes|Yes|
|Windows SE|No|Yes|
|Business|Yes|Yes|
|Enterprise|Yes|Yes|
|Education|Yes|Yes|
> [!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 WiredNetwork configuration service provider (CSP) is used by the enterprise to configure wired Internet on devices that don't have GP to enable them to access corporate Internet over ethernet. This CSP was added in Windows 10, version 1809.
<!-- WiredNetwork-Tree-Begin -->
The following example shows the WiredNetwork configuration service provider in tree format. The following example shows the WiredNetwork configuration service provider in tree format.
```text
./Device/Vendor/MSFT/WiredNetwork
--- EnableBlockPeriod
--- LanXML
./User/Vendor/MSFT/WiredNetwork
--- EnableBlockPeriod
--- LanXML
``` ```
./User/Vendor/MSFT <!-- WiredNetwork-Tree-End -->
WiredNetwork
----LanXML
----EnableBlockPeriod
<!-- Device-EnableBlockPeriod-Begin -->
## Device/EnableBlockPeriod
./Device/Vendor/MSFT <!-- Device-EnableBlockPeriod-Applicability-Begin -->
WiredNetwork | Scope | Editions | Applicable OS |
----LanXML |:--|:--|:--|
----EnableBlockPeriod | :heavy_check_mark: Device <br> :heavy_check_mark: User | :x: Home <br> :heavy_check_mark: Pro <br> :heavy_check_mark: Enterprise <br> :heavy_check_mark: Education <br> :heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1809 [10.0.17763] and later |
<!-- Device-EnableBlockPeriod-Applicability-End -->
<!-- Device-EnableBlockPeriod-OmaUri-Begin -->
./User/Vendor/MSFT ```Device
./Device/Vendor/MSFT ./Device/Vendor/MSFT/WiredNetwork/EnableBlockPeriod
WiredNetwork
----LanXML
----EnableBlockPeriod
``` ```
<a href="" id="wirednetwork"></a>**./Device/Vendor/MSFT/WiredNetwork** <!-- Device-EnableBlockPeriod-OmaUri-End -->
The root node for the wirednetwork configuration service provider.
<a href="" id="lanxml"></a>**LanXML** <!-- Device-EnableBlockPeriod-Description-Begin -->
Optional. XML describing the wired network configuration and follows the LAN_profile schemas https://msdn.microsoft.com/library/windows/desktop/aa816366(v=vs.85).aspx. <!-- Description-Source-DDF -->
Enable block period (minutes), used to specify the duration for which automatic authentication attempts will be blocked from occurring after a failed authentication attempt.
<!-- Device-EnableBlockPeriod-Description-End -->
- Supported operations are Add, Get, Replace, and Delete. <!-- Device-EnableBlockPeriod-Editable-Begin -->
- Value type is string. <!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
<!-- Device-EnableBlockPeriod-Editable-End -->
<a href="" id="enableblockperiod"></a>**EnableBlockPeriod** <!-- Device-EnableBlockPeriod-DFProperties-Begin -->
Optional. Enable block period (minutes), used to specify the duration for which automatic authentication attempts will be blocked from occurring after a failed authentication attempt. **Description framework properties**:
- Supported operations are Add, Get, Replace, and Delete. | Property name | Property value |
- Value type is integer. |:--|:--|
| Format | int |
| Access Type | Add, Delete, Get, Replace |
| Allowed Values | Range: `[0-4294967295]` |
<!-- Device-EnableBlockPeriod-DFProperties-End -->
<!-- Device-EnableBlockPeriod-Examples-Begin -->
<!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- Device-EnableBlockPeriod-Examples-End -->
<!-- Device-EnableBlockPeriod-End -->
<!-- Device-LanXML-Begin -->
## Device/LanXML
<!-- Device-LanXML-Applicability-Begin -->
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| :heavy_check_mark: Device <br> :heavy_check_mark: User | :x: Home <br> :heavy_check_mark: Pro <br> :heavy_check_mark: Enterprise <br> :heavy_check_mark: Education <br> :heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1809 [10.0.17763] and later |
<!-- Device-LanXML-Applicability-End -->
<!-- Device-LanXML-OmaUri-Begin -->
```Device
./Device/Vendor/MSFT/WiredNetwork/LanXML
```
<!-- Device-LanXML-OmaUri-End -->
<!-- Device-LanXML-Description-Begin -->
<!-- Description-Source-DDF -->
XML describing the wired network configuration and follows the LAN_profile schemas <https://msdn.microsoft.com/library/windows/desktop/aa816366(v=vs.85).aspx>.
<!-- Device-LanXML-Description-End -->
<!-- Device-LanXML-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
<!-- Device-LanXML-Editable-End -->
<!-- Device-LanXML-DFProperties-Begin -->
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | chr (string) |
| Access Type | Add, Delete, Get, Replace |
<!-- Device-LanXML-DFProperties-End -->
<!-- Device-LanXML-Examples-Begin -->
<!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- Device-LanXML-Examples-End -->
<!-- Device-LanXML-End -->
<!-- User-EnableBlockPeriod-Begin -->
## User/EnableBlockPeriod
<!-- User-EnableBlockPeriod-Applicability-Begin -->
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| :heavy_check_mark: Device <br> :heavy_check_mark: User | :x: Home <br> :heavy_check_mark: Pro <br> :heavy_check_mark: Enterprise <br> :heavy_check_mark: Education <br> :heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1809 [10.0.17763] and later |
<!-- User-EnableBlockPeriod-Applicability-End -->
<!-- User-EnableBlockPeriod-OmaUri-Begin -->
```User
./User/Vendor/MSFT/WiredNetwork/EnableBlockPeriod
```
<!-- User-EnableBlockPeriod-OmaUri-End -->
<!-- User-EnableBlockPeriod-Description-Begin -->
<!-- Description-Source-DDF -->
Enable block period (minutes), used to specify the duration for which automatic authentication attempts will be blocked from occurring after a failed authentication attempt.
<!-- User-EnableBlockPeriod-Description-End -->
<!-- User-EnableBlockPeriod-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
<!-- User-EnableBlockPeriod-Editable-End -->
<!-- User-EnableBlockPeriod-DFProperties-Begin -->
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | int |
| Access Type | Add, Delete, Get, Replace |
| Allowed Values | Range: `[0-4294967295]` |
<!-- User-EnableBlockPeriod-DFProperties-End -->
<!-- User-EnableBlockPeriod-Examples-Begin -->
<!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- User-EnableBlockPeriod-Examples-End -->
<!-- User-EnableBlockPeriod-End -->
<!-- User-LanXML-Begin -->
## User/LanXML
<!-- User-LanXML-Applicability-Begin -->
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| :heavy_check_mark: Device <br> :heavy_check_mark: User | :x: Home <br> :heavy_check_mark: Pro <br> :heavy_check_mark: Enterprise <br> :heavy_check_mark: Education <br> :heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1809 [10.0.17763] and later |
<!-- User-LanXML-Applicability-End -->
<!-- User-LanXML-OmaUri-Begin -->
```User
./User/Vendor/MSFT/WiredNetwork/LanXML
```
<!-- User-LanXML-OmaUri-End -->
<!-- User-LanXML-Description-Begin -->
<!-- Description-Source-DDF -->
XML describing the wired network configuration and follows the LAN_profile schemas <https://msdn.microsoft.com/library/windows/desktop/aa816366(v=vs.85).aspx>.
<!-- User-LanXML-Description-End -->
<!-- User-LanXML-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
<!-- User-LanXML-Editable-End -->
<!-- User-LanXML-DFProperties-Begin -->
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | chr (string) |
| Access Type | Add, Delete, Get, Replace |
<!-- User-LanXML-DFProperties-End -->
<!-- User-LanXML-Examples-Begin -->
<!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- User-LanXML-Examples-End -->
<!-- User-LanXML-End -->
<!-- WiredNetwork-CspMoreInfo-Begin -->
<!-- Add any additional information about this CSP here. Anything outside this section will get overwritten. -->
## Examples
The following example shows how to add a wired network profile: The following example shows how to add a wired network profile:
```xml ```xml
<SyncML xmlns="SYNCML:SYNCML1.2"> <SyncML xmlns="SYNCML:SYNCML1.2">
<SyncBody> <SyncBody>
@ -83,7 +216,10 @@ The following example shows how to add a wired network profile:
</SyncBody> </SyncBody>
</SyncML> </SyncML>
``` ```
<!-- WiredNetwork-CspMoreInfo-End -->
## Related topics <!-- WiredNetwork-End -->
[Configuration service provider reference](index.yml) ## Related articles
[Configuration service provider reference](configuration-service-provider-reference.md)

View File

@ -1,173 +1,190 @@
--- ---
title: WiredNetwork DDF file title: WiredNetwork DDF file
description: This topic shows the OMA DM device description framework (DDF) for the WiredNetwork configuration service provider. description: View the XML file containing the device description framework (DDF) for the WiredNetwork configuration service provider.
author: vinaypamnani-msft
manager: aaroncz
ms.author: vinpa ms.author: vinpa
ms.topic: article ms.date: 02/16/2023
ms.localizationpriority: medium
ms.prod: windows-client ms.prod: windows-client
ms.technology: itpro-manage ms.technology: itpro-manage
author: vinaypamnani-msft ms.topic: reference
ms.date: 06/28/2018
ms.reviewer:
manager: aaroncz
--- ---
<!-- Auto-Generated CSP Document -->
# WiredNetwork DDF file # WiredNetwork DDF file
The following XML file contains the device description framework (DDF) for the WiredNetwork configuration service provider.
This topic shows the OMA DM device description framework (DDF) for the WiredNetwork configuration service provider. This CSP was added in Windows 10, version 1511.
Looking for the DDF XML files? See [CSP DDF files download](configuration-service-provider-ddf.md).
The XML below is the current version for this CSP.
```xml ```xml
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE MgmtTree PUBLIC " -//OMA//DTD-DM-DDF 1.2//EN" <!DOCTYPE MgmtTree PUBLIC " -//OMA//DTD-DM-DDF 1.2//EN" "http://www.openmobilealliance.org/tech/DTD/DM_DDF-V1_2.dtd"[<?oma-dm-ddf-ver supported-versions="1.2"?>]>
"http://www.openmobilealliance.org/tech/DTD/DM_DDF-V1_2.dtd"
[<?oma-dm-ddf-ver supported-versions="1.2"?>]>
<MgmtTree xmlns:MSFT="http://schemas.microsoft.com/MobileDevice/DM"> <MgmtTree xmlns:MSFT="http://schemas.microsoft.com/MobileDevice/DM">
<VerDTD>1.2</VerDTD> <VerDTD>1.2</VerDTD>
<Node> <MSFT:Diagnostics>
<NodeName>WiredNetwork</NodeName> </MSFT:Diagnostics>
<Path>./User/Vendor/MSFT</Path> <Node>
<DFProperties> <NodeName>WiredNetwork</NodeName>
<AccessType> <Path>./User/Vendor/MSFT</Path>
<Get /> <DFProperties>
</AccessType> <AccessType>
<DFFormat> <Get />
<node /> </AccessType>
</DFFormat> <DFFormat>
<Occurrence> <node />
<One /> </DFFormat>
</Occurrence> <Occurrence>
<Scope> <One />
<Permanent /> </Occurrence>
</Scope> <Scope>
<DFType> <Permanent />
<DDFName></DDFName> </Scope>
</DFType> <DFType>
</DFProperties> <MIME />
<Node> </DFType>
<NodeName>LanXML</NodeName> <MSFT:Applicability>
<DFProperties> <MSFT:OsBuildVersion>10.0.17763</MSFT:OsBuildVersion>
<AccessType> <MSFT:CspVersion>1.0</MSFT:CspVersion>
<Get /> <MSFT:EditionAllowList>0x4;0x1B;0x30;0x31;0x48;0x54;0x62;0x63;0x64;0x65;0x77;0x79;0x7A;0x7D;0x7E;0x81;0x82;0x8A;0x8B;0xA1;0xA2;0xA4;0xA5;0xAB;0xAC;0xB4;0xBC;0xBF;0xCA;0xCB;0xCD;</MSFT:EditionAllowList>
<Add /> </MSFT:Applicability>
<Delete /> </DFProperties>
<Replace /> <Node>
</AccessType> <NodeName>LanXML</NodeName>
<Description>XML describing the wired network configuration and follows the LAN_profile schemas https://msdn.microsoft.com/library/windows/desktop/aa816366(v=vs.85).aspx</Description> <DFProperties>
<DFFormat> <AccessType>
<chr /> <Add />
</DFFormat> <Delete />
<Occurrence> <Get />
<ZeroOrOne /> <Replace />
</Occurrence> </AccessType>
<Scope> <Description>XML describing the wired network configuration and follows the LAN_profile schemas https://msdn.microsoft.com/en-us/library/windows/desktop/aa816366(v=vs.85).aspx</Description>
<Dynamic /> <DFFormat>
</Scope> <chr />
<DFType> </DFFormat>
<MIME>text/plain</MIME> <Occurrence>
</DFType> <ZeroOrOne />
</DFProperties> </Occurrence>
</Node> <Scope>
<Node> <Dynamic />
<NodeName>EnableBlockPeriod</NodeName> </Scope>
<DFProperties> <DFType>
<AccessType> <MIME />
<Get /> </DFType>
<Add /> <MSFT:AllowedValues ValueType="None">
<Delete /> </MSFT:AllowedValues>
<Replace /> </DFProperties>
</AccessType> </Node>
<Description> Enable block period (minutes), used to specify the duration for which automatic authentication attempts will be blocked from occurring after a failed authentication attempt.</Description> <Node>
<DFFormat> <NodeName>EnableBlockPeriod</NodeName>
<int /> <DFProperties>
</DFFormat> <AccessType>
<Occurrence> <Add />
<ZeroOrOne /> <Delete />
</Occurrence> <Get />
<Scope> <Replace />
<Dynamic /> </AccessType>
</Scope> <Description> Enable block period (minutes), used to specify the duration for which automatic authentication attempts will be blocked from occurring after a failed authentication attempt.</Description>
<DFType> <DFFormat>
<MIME>text/plain</MIME> <int />
</DFType> </DFFormat>
</DFProperties> <Occurrence>
</Node> <ZeroOrOne />
</Node> </Occurrence>
<Node> <Scope>
<NodeName>WiredNetwork</NodeName> <Dynamic />
<Path>./Device/Vendor/MSFT</Path> </Scope>
<DFProperties> <DFType>
<AccessType> <MIME />
<Get /> </DFType>
</AccessType> <MSFT:AllowedValues ValueType="Range">
<DFFormat> <MSFT:Value>[0-4294967295]</MSFT:Value>
<node /> </MSFT:AllowedValues>
</DFFormat> </DFProperties>
<Occurrence> </Node>
<One /> </Node>
</Occurrence> <Node>
<Scope> <NodeName>WiredNetwork</NodeName>
<Permanent /> <Path>./Device/Vendor/MSFT</Path>
</Scope> <DFProperties>
<DFType> <AccessType>
<DDFName></DDFName> <Get />
</DFType> </AccessType>
</DFProperties> <DFFormat>
<Node> <node />
<NodeName>LanXML</NodeName> </DFFormat>
<DFProperties> <Occurrence>
<AccessType> <One />
<Get /> </Occurrence>
<Add /> <Scope>
<Delete /> <Permanent />
<Replace /> </Scope>
</AccessType> <DFType>
<Description>XML describing the wired network configuration and follows the LAN_profile schemas https://msdn.microsoft.com/library/windows/desktop/aa816366(v=vs.85).aspx</Description> <MIME />
<DFFormat> </DFType>
<chr /> <MSFT:Applicability>
</DFFormat> <MSFT:OsBuildVersion>10.0.17763</MSFT:OsBuildVersion>
<Occurrence> <MSFT:CspVersion>1.0</MSFT:CspVersion>
<ZeroOrOne /> <MSFT:EditionAllowList>0x4;0x1B;0x30;0x31;0x48;0x54;0x62;0x63;0x64;0x65;0x77;0x79;0x7A;0x7D;0x7E;0x81;0x82;0x8A;0x8B;0xA1;0xA2;0xA4;0xA5;0xAB;0xAC;0xB4;0xBC;0xBF;0xCA;0xCB;0xCD;</MSFT:EditionAllowList>
</Occurrence> </MSFT:Applicability>
<Scope> </DFProperties>
<Dynamic /> <Node>
</Scope> <NodeName>LanXML</NodeName>
<DFType> <DFProperties>
<MIME>text/plain</MIME> <AccessType>
</DFType> <Add />
</DFProperties> <Delete />
</Node> <Get />
<Node> <Replace />
<NodeName>EnableBlockPeriod</NodeName> </AccessType>
<DFProperties> <Description>XML describing the wired network configuration and follows the LAN_profile schemas https://msdn.microsoft.com/en-us/library/windows/desktop/aa816366(v=vs.85).aspx</Description>
<AccessType> <DFFormat>
<Get /> <chr />
<Add /> </DFFormat>
<Delete /> <Occurrence>
<Replace /> <ZeroOrOne />
</AccessType> </Occurrence>
<Description> Enable block period (minutes), used to specify the duration for which automatic authentication attempts will be blocked from occurring after a failed authentication attempt.</Description> <Scope>
<DFFormat> <Dynamic />
<int /> </Scope>
</DFFormat> <DFType>
<Occurrence> <MIME />
<ZeroOrOne /> </DFType>
</Occurrence> <MSFT:AllowedValues ValueType="None">
<Scope> </MSFT:AllowedValues>
<Dynamic /> </DFProperties>
</Scope> </Node>
<DFType> <Node>
<MIME>text/plain</MIME> <NodeName>EnableBlockPeriod</NodeName>
</DFType> <DFProperties>
</DFProperties> <AccessType>
</Node> <Add />
</Node> <Delete />
<Get />
<Replace />
</AccessType>
<Description> Enable block period (minutes), used to specify the duration for which automatic authentication attempts will be blocked from occurring after a failed authentication attempt.</Description>
<DFFormat>
<int />
</DFFormat>
<Occurrence>
<ZeroOrOne />
</Occurrence>
<Scope>
<Dynamic />
</Scope>
<DFType>
<MIME />
</DFType>
<MSFT:AllowedValues ValueType="Range">
<MSFT:Value>[0-4294967295]</MSFT:Value>
</MSFT:AllowedValues>
</DFProperties>
</Node>
</Node>
</MgmtTree> </MgmtTree>
``` ```
## Related topics ## Related articles
[WiredNetwork CSP](wirednetwork-csp.md) [WiredNetwork configuration service provider reference](wirednetwork-csp.md)