Set-DscLocalConfigurationManager

参考

模块:: PSDesiredStateConfiguration

将本地Configuration Manager (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>]

说明

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

示例

示例 1：应用 LCM 设置

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

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

警告

如果指定文件夹中存储的同一台计算机有多个元 mof，则仅应用第一个元 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。

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

参数

-CimSession

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

Type:	CimSession[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ComputerName

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

Type:	String[]
Aliases:	CN, ServerName
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

针对目标计算机，指定用户名和密码作为 PSCredential 对象。若要获取 PSCredential 对象，请使用 Get-Credential cmdlet。要了解详情，请键入 Get-Help Get-Credential。

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

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

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ThrottleLimit

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

通过