Get-DscConfiguration
取得節點的目前組態。
Syntax
Get-DscConfiguration
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[<CommonParameters>]
Description
Get-DscConfiguration
如果組態存在,此 Cmdlet 會取得節點的目前組態。 使用通用訊息模型 (CIM) 工作階段指定電腦。 如果您沒有指定目標電腦,此 Cmdlet 會從本機電腦取得設定。
範例
範例 1:取得本機電腦的設定
Get-DscConfiguration
此命令會取得本機電腦的目前狀態。
範例 2:取得指定電腦的組態
$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Get-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。 輸入電腦名稱稱或會話物件,例如 New-CimSession 或 Get-CimSession Cmdlet 的輸出。 預設為本機電腦上的目前工作階段。
Type: | CimSession[] |
Aliases: | Session |
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 |