Share via

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