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>]

说明

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

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

示例

示例 1：更新配置

Update-DscConfiguration -Wait -Verbose

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

示例 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。

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

参数

-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

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

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

-JobName

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

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

如果指定 Wait 参数，则不指定此参数。

Type:	String
Position:	Named
Default value:	None
Required:	False
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

-Wait

指示 cmdlet 在完成所有配置任务之前阻止控制台。

如果指定此参数，则不指定 JobName 参数。

Type:	SwitchParameter
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