11---
2- ms.date : 06/21/2023
2+ ms.date : 05/08/2025
33keywords : dsc,powershell,configuration,setup
44title : Set up a Pull Client using Configuration Names in PowerShell 5.0 and later
55description : The article explains how to set up a Pull Client using Configuration Names in PowerShell 5.0 and later
@@ -12,28 +12,28 @@ description: The article explains how to set up a Pull Client using Configuratio
1212> The Pull Server (Windows Feature * DSC-Service* ) is a supported component of Windows Server however
1313> there are no plans to offer new features or capabilities. we would like you to know that a newer
1414> version of DSC is now generally available, managed by a feature of Azure Policy named
15- > [ guest configuration] ( /azure/governance/machine-configuration/overview ) . The guest configuration
16- > service combines features of DSC Extension, Azure Automation State Configuration, and the most
17- > commonly requested features from customer feedback. Guest configuration also includes hybrid
18- > machine support through [ Arc-enabled servers] ( /azure/azure-arc/servers/overview ) .
15+ > [ guest configuration] [ 03 ] . The guest configuration service combines features of DSC Extension,
16+ > Azure Automation State Configuration, and the most commonly requested features from customer
17+ > feedback. Guest configuration also includes hybrid machine support through
18+ > [ Arc-enabled servers] [ 02 ] .
1919
2020Before setting up a pull client, you should set up a pull server. Though this order is not required,
2121it helps with troubleshooting, and helps you ensure that the registration was successful. To set up
2222a pull server, you can use the following guides:
2323
24- - [ Set up a DSC SMB Pull Server] ( pullServerSmb.md )
25- - [ Set up a DSC HTTP Pull Server] ( pullServer.md )
24+ - [ Set up a DSC SMB Pull Server] [ 09 ]
25+ - [ Set up a DSC HTTP Pull Server] [ 08 ]
2626
2727Each target node can be configured to download configurations, resources, and even report its
2828status. The sections below show you how to configure a pull client with an SMB share or HTTP DSC
2929Pull Server. When the Node's LCM refreshes, it will reach out to the configured location to download
3030any assigned configurations. If any required resources do not exist on the Node, it will
3131automatically download them from the configured location. If the Node is configured with a
32- [ Report Server] ( reportServer.md ) , it will then report the status of the operation.
32+ [ Report Server] [ 10 ] , it will then report the status of the operation.
3333
3434> [ !NOTE]
3535> This topic applies to PowerShell 5.0. For information on setting up a pull client in PowerShell
36- > 4.0, see [ Set up a pull client using configuration ID in PowerShell 4.0] ( pullClientConfigID4.md )
36+ > 4.0, see [ Set up a pull client using configuration ID in PowerShell 4.0] [ 07 ] .
3737
3838## Configure the pull client LCM
3939
@@ -54,16 +54,15 @@ The examples below sets the **ConfigurationName** property of the LCM to the nam
5454compiled Configuration, created for this purpose. The ** ConfigurationName** is what the LCM uses to
5555find the appropriate configuration on the pull server. The configuration MOF file on the pull server
5656must be named ` <ConfigurationName>.mof ` , in this case, "ClientConfig.mof". For more information, see
57- [ Publish Configurations to a Pull Server (v4/v5)] ( publishConfigs.md ) .
57+ [ Publish Configurations to a Pull Server (v4/v5)] [ 05 ] .
5858
5959## Set up a Pull Client to download Configurations
6060
6161Each client must be configured in ** Pull** mode and given the pull server url where its
6262configuration is stored. To do this, you have to configure the Local Configuration Manager (LCM)
6363with the necessary information. To configure the LCM, you create a special type of configuration,
6464decorated with the ** DSCLocalConfigurationManager** attribute. For more information about
65- configuring the LCM, see
66- [ Configuring the Local Configuration Manager] ( ../managing-nodes/metaConfig.md ) .
65+ configuring the LCM, see [ Configuring the Local Configuration Manager] [ 01 ] .
6766
6867The following script configures the LCM to pull configurations from a server named
6968"CONTOSO-PullSrv".
@@ -77,14 +76,13 @@ The following script configures the LCM to pull configurations from a server nam
7776 > [ !NOTE]
7877 > Registration keys work only with ** web** pull servers. You must still use ** ConfigurationID**
7978 > with an ** SMB** pull server. > For information about configuring a pull server by using
80- > ** ConfigurationID** , see
81- > [ Setting up a pull client using configuration ID] ( pullClientConfigId.md )
79+ > ** ConfigurationID** , see [ Setting up a pull client using configuration ID] [ 06 ]
8280
8381- The ** ConfigurationNames** property is an array that specifies the names of the configurations
8482 intended for the client node. >** Note:** If you specify more than one value in the
8583 ** ConfigurationNames** , you must also specify ** PartialConfiguration** blocks in your
8684 configuration. >For information about partial configurations, see
87- [ PowerShell Desired State Configuration partial configurations] ( partialConfigs.md ) .
85+ [ PowerShell Desired State Configuration partial configurations] [ 04 ] .
8886
8987``` powershell
9088[DSCLocalConfigurationManager()]
@@ -189,5 +187,18 @@ PullClientConfigNames
189187
190188## See Also
191189
192- - [ Setting up a pull client with configuration ID] ( PullClientConfigNames.md )
193- - [ Setting up a DSC web pull server] ( pullServer.md )
190+ - [ Setting up a pull client with configuration ID] [ 00 ]
191+ - [ Setting up a DSC web pull server] [ 08 ]
192+
193+ <!-- link references -->
194+ [ 00 ] : pullClientConfigID.md
195+ [ 01 ] : ../managing-nodes/metaConfig.md
196+ [ 02 ] : /azure/azure-arc/servers/overview
197+ [ 03 ] : /azure/governance/machine-configuration/overview
198+ [ 04 ] : partialConfigs.md
199+ [ 05 ] : publishConfigs.md
200+ [ 06 ] : pullClientConfigId.md
201+ [ 07 ] : pullClientConfigID4.md
202+ [ 08 ] : pullServer.md
203+ [ 09 ] : pullServerSmb.md
204+ [ 10 ] : reportServer.md
0 commit comments