Restore-DscConfiguration

重新应用节点以前的配置。

语法

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

第二个命令还原由存储在 变量中的 $SessionCimSession 对象标识的计算机的配置,在本例中为名为 Server01 的计算机。

参数

-AsJob

指示此 cmdlet 将命令作为后台作业运行。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CimSession

在远程会话中或在远程计算机上运行 cmdlet。 输入计算机名称或会话对象,例如 或 Get-CimSession cmdlet 的New-CimSession输出。

Type:CimSession[]
Aliases:Session
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

-ThrottleLimit

指定可为运行 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