Set-DscLocalConfigurationManager

参考

模块:: PSDesiredStateConfiguration

将本地配置管理器（LCM）设置应用于节点。

语法

Set-DscLocalConfigurationManager
   [-Path] <String>
   [-Force]
   [[-ComputerName] <String[]>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-DscLocalConfigurationManager
   [-Path] <String>
   [-Force]
   [-ThrottleLimit <Int32>]
   -CimSession <CimSession[]>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-DscLocalConfigurationManager cmdlet 将 LCM 设置或元配置应用于节点。通过指定计算机名称或使用通用信息模型（CIM）会话来指定计算机。如果未指定目标计算机，则 cmdlet 会将设置应用于本地计算机。

示例

示例 1：应用 LCM 设置

Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\"

此命令将 C:\DSC\Configurations\ 中的 LCM 设置应用于目标节点。收到设置后，LCM 会处理这些设置。

警告

如果指定文件夹中存储的同一台计算机有多个元 mofs，则只会应用第一个元 mof。

示例 2：使用 CIM 会话应用 LCM 设置

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\" -CimSession $Session

此示例将 LCM 设置应用于计算机并应用设置。该示例为名为 Server01 的计算机创建 CIM 会话，以便与 cmdlet 一起使用。或者，创建一组 CIM 会话，以将 cmdlet 应用于多个指定的计算机。

第一个命令使用 New-CimSession cmdlet 创建 CIM 会话，然后将 CimSession 对象存储在 $Session 变量中。该命令会提示输入密码。有关详细信息，请键入 Get-Help New-CimSession。

第二个命令将目标节点的 LCM 设置从 C:\DSC\Configurations\ 应用到 CimSession 存储在 $Session 变量中的对象标识的计算机。在此示例中，$Session 变量仅包含名为 Server01 的计算机的 CIM 会话。该命令应用设置。收到设置后，LCM 会处理这些设置。

参数

-CimSession

在远程会话或远程计算机上运行 cmdlet。输入计算机名或会话对象，例如 New-CimSession 或 Get-CimSession cmdlet 的输出。默认值为本地计算机上的当前会话。

类型:	CimSession[]
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-ComputerName

指定计算机名称数组。此参数将 Path 参数中具有元配置文档的计算机限制为数组中指定的文档。

类型:	String[]
别名:	CN, ServerName
Position:	1
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-Credential

指定目标计算机的 PSCredential 对象的用户名和密码。若要获取 PSCredential 对象，请使用 Get-Credential cmdlet。有关详细信息，请键入 Get-Help Get-Credential。

类型:	PSCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Force

强制命令运行而不要求用户确认。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Path

指定包含配置设置文件的文件夹的文件路径。该 cmdlet 发布这些 LCM 设置并将其应用于具有指定路径中设置文件的计算机。每个目标节点必须具有以下格式的设置文件：NetBIOS Name.meta.mof。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ThrottleLimit

指定可以建立以运行 cmdlet 的最大并发作数。如果省略此参数或输入 0 值，则 Windows PowerShell 会根据计算机上运行的 CIM cmdlet 数计算 cmdlet 的最佳限制。限制限制仅适用于当前 cmdlet，不适用于会话或计算机。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

通过