Skip to content

Commit 9bd601c

Browse files
authored
Merge pull request #323 from MicrosoftDocs/main
5/8/2025 PM Publish
2 parents 9393591 + 3eb7ef2 commit 9bd601c

File tree

2 files changed

+117
-96
lines changed

2 files changed

+117
-96
lines changed

dsc/docs-conceptual/dsc-1.1/pull-server/pullClientConfigNames.md

Lines changed: 28 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
ms.date: 06/21/2023
2+
ms.date: 05/08/2025
33
keywords: dsc,powershell,configuration,setup
44
title: Set up a Pull Client using Configuration Names in PowerShell 5.0 and later
55
description: 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
2020
Before setting up a pull client, you should set up a pull server. Though this order is not required,
2121
it helps with troubleshooting, and helps you ensure that the registration was successful. To set up
2222
a 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

2727
Each target node can be configured to download configurations, resources, and even report its
2828
status. The sections below show you how to configure a pull client with an SMB share or HTTP DSC
2929
Pull Server. When the Node's LCM refreshes, it will reach out to the configured location to download
3030
any assigned configurations. If any required resources do not exist on the Node, it will
3131
automatically 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
5454
compiled Configuration, created for this purpose. The **ConfigurationName** is what the LCM uses to
5555
find the appropriate configuration on the pull server. The configuration MOF file on the pull server
5656
must 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

6161
Each client must be configured in **Pull** mode and given the pull server url where its
6262
configuration is stored. To do this, you have to configure the Local Configuration Manager (LCM)
6363
with the necessary information. To configure the LCM, you create a special type of configuration,
6464
decorated 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

6867
The 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

Comments
 (0)