Restore-DscConfiguration
重新应用节点的上一个配置。
语法
Default (默认值)
Restore-DscConfiguration
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
如果存在以前的配置,Restore-DscConfiguration cmdlet 会重新应用节点的上一个配置。 使用通用信息模型 (CIM) 会话指定计算机。
如果未指定目标计算机,则 cmdlet 将还原本地计算机的配置。 如果某个特定节点没有以前的配置,此 cmdlet 将返回一条错误消息。
此 cmdlet 不支持 Confirm 参数。
示例
示例 1:还原本地计算机的配置
Restore-DscConfiguration
此命令将还原本地计算机的配置。
示例 2:还原指定计算机的配置
$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Restore-DscConfiguration -CimSession $Session
此示例在 CIM 会话指定的计算机上还原配置。 该示例为名为 Server01 的计算机创建 CIM 会话,以便与 cmdlet 一起使用。 或者,创建一组 CIM 会话,以将 cmdlet 应用于多个指定的计算机。
第一个命令使用 New-CimSession cmdlet 创建 CIM 会话,然后将 CimSession 对象存储在 $Session 变量中。 该命令会提示输入密码。 要了解详情,请键入 Get-Help New-CimSession。
第二个命令将还原 CimSession 存储在 $Session 变量中的对象的配置,在本例中为名为 Server01 的计算机。
参数
-AsJob
指示此 cmdlet 以后台作业的形式运行命令。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-CimSession
在远程会话或远程计算机上运行 cmdlet。 输入计算机名或会话对象,例如 New-CimSession 或 Get-CimSession cmdlet 的输出。
参数属性
| 类型: | |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 会话 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Confirm
在运行 cmdlet 之前,提示你进行确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ThrottleLimit
指定可以建立以运行 cmdlet 的最大并发操作数。
参数属性
| 类型: | Int32 |
| 默认值: | 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。