Update-DscConfiguration
检查请求服务器是否有更新的配置并应用它。
语法
ComputerNameSet （默认值）
Update-DscConfiguration
[[-ComputerName] <String[]>]
[-Wait]
[-JobName <String>]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CimSessionSet
Update-DscConfiguration
-CimSession <CimSession[]>
[-Wait]
[-JobName <String>]
[-ThrottleLimit <Int32>]
[-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 中指定的计算机。 该命令指定 Wait 参数。 在当前命令完成之前，控制台不接受其他命令。
参数
-CimSession
在远程会话或远程计算机上运行 cmdlet。 输入计算机名或会话对象，例如 New-CimSession 或 Get-CimSession cmdlet 的输出。 默认值为本地计算机上的当前会话。
参数属性
| 类型: | |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
CimSessionSet
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ComputerName
指定计算机名称数组。 该 cmdlet 将配置设置应用于此参数指定的计算机。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 中国区, 服务器名称 |
参数集
ComputerNameSet
| Position: | 1 |
| 必需: | False |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Confirm
在运行 cmdlet 之前，提示你进行确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Credential
指定目标计算机的 PSCredential 对象的用户名和密码。 若要获取 PSCredential 对象，请使用 Get-Credential cmdlet。 要了解详情，请键入 Get-Help Get-Credential。
参数属性
| 类型: | PSCredential |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
ComputerNameSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-JobName
指定作业的友好名称。 如果指定此参数，则 cmdlet 将作为作业运行，并返回 Job 对象。
默认情况下，Windows PowerShell 分配名称 JobN，其中 N 是整数。
如果指定 Wait 参数，请不要指定此参数。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ThrottleLimit
指定可以建立以运行 cmdlet 的最大并发操作数。 如果省略此参数或输入 0 值，则 Windows PowerShell 会根据计算机上运行的 CIM cmdlet 数计算 cmdlet 的最佳限制。 限制限制仅适用于当前 cmdlet，不适用于会话或计算机。
参数属性
| 类型: | Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Wait
指示 cmdlet 会阻止控制台，直到它完成所有配置任务。
如果指定此参数，请不要指定 JobName 参数。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
