Update-DscConfiguration

参考

模块:: PSDesiredStateConfiguration

检查请求服务器是否有更新的配置并应用它。

语法

Update-DscConfiguration
      [-Wait]
      [-JobName <String>]
      [[-ComputerName] <String[]>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-DscConfiguration
      [-Wait]
      [-JobName <String>]
      [-ThrottleLimit <Int32>]
      -CimSession <CimSession[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Update-DscConfiguration cmdlet 连接到请求服务器，如果配置与节点上的当前内容不同，则下载配置，然后将配置应用到计算机。

此 cmdlet 仅作为 Windows RT 8.1、Windows 8.1 和 Windows Server 2012 R2 2014 年 11 月更新汇总的一部分提供。

示例

示例 1：更新配置

Update-DscConfiguration -Wait -Verbose

运行此命令后，服务器将连接到已注册的拉取服务，下载最新分配的配置，然后应用它。 Wait 和详细参数是可选的。以交互方式工作时，这些参数在应用配置时启用有关进度和成功或失败的实时反馈。

示例 2：通过 CIM 会话进行连接来更新配置

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Update-DscConfiguration -CimSession $Session -Wait

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

第二个命令更新存储在 $Session中的 CimSession 中指定的计算机。该命令指定 Wait 参数。在当前命令完成之前，控制台不接受其他命令。

参数

-CimSession

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

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

-ComputerName

指定计算机名称数组。该 cmdlet 将配置设置应用于此参数指定的计算机。

类型:	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

-JobName

指定作业的友好名称。如果指定此参数，则 cmdlet 将作为作业运行，并返回 Job 对象。

默认情况下，Windows PowerShell 分配名称 JobN，其中 N 是整数。

如果指定 Wait 参数，请不要指定此参数。

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

-ThrottleLimit

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

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

-Wait

指示 cmdlet 会阻止控制台，直到它完成所有配置任务。

如果指定此参数，请不要指定 JobName 参数。

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

-WhatIf

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

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

通过