Restore-DscConfiguration
重新套用先前的節點設定。
Syntax
Restore-DscConfiguration
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
如果先前的組態存在,Cmdlet Restore-DscConfiguration
就會重新套用節點的先前設定。 使用通用訊息模型 (CIM) 工作階段指定電腦。
如果您沒有指定目標電腦,此 Cmdlet 會還原本機電腦的設定。 如果先前沒有針對特定節點的設定,此 Cmdlet 會傳回錯誤訊息。
此 Cmdlet 不支援 Confirm 參數。
範例
範例 1:還原本機電腦的設定
Restore-DscConfiguration
此命令會還原本機電腦的設定。
範例 2:還原指定電腦的設定
$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Restore-DscConfiguration -CimSession $Session
這個範例會還原 CIM 工作階段所指定之電腦上的設定。 這個範例會針對名為 Server01 的電腦,建立一個搭配此 Cmdlet 使用的 CIM 工作階段。 或者,建立一個 CIM 工作階段的陣列,以便將該 Cmdlet 套用到多部指定的電腦。
第一個命令會使用 New-CimSession
Cmdlet 建立 CIM 會話,然後將 CimSession 物件儲存在變數中 $Session
。 此命令會提示您輸入密碼。 如需詳細資訊,請鍵入 Get-Help New-CimSession
。
第二個命令會還原儲存在變數中 $Session
CimSession物件所識別之電腦的組態,在此案例中為名為 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 |