Get-DscConfiguration
取得節點的目前組態。
語法
Get-DscConfiguration
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[<CommonParameters>]
Description
如果組態存在,則 Get-DscConfiguration
Cmdlet 會取得節點的目前組態。 使用 Common Information Model (CIM) 會話來指定電腦。 如果您未指定目標計算機,Cmdlet 會從本機電腦取得組態。
範例
範例 1:取得本機計算機的設定
Get-DscConfiguration
此命令會取得本機電腦的目前狀態。
範例 2:取得指定計算機的組態
$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Get-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 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-CimSession
在遠端會話或遠端電腦上執行 Cmdlet。 輸入計算機名稱或會話物件,例如 New-CimSession 或 Get-CimSession Cmdlet 的輸出。 預設為本機電腦上的目前會話。
類型: | CimSession[] |
別名: | Session |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ThrottleLimit
指定可以建立以執行 Cmdlet 的並行作業數目上限。 如果省略此參數或輸入 0
的值,則 Windows PowerShell 會根據計算機上執行的 CIM Cmdlet 數目,計算 Cmdlet 的最佳節流限制。 節流限制僅適用於目前的 Cmdlet,不適用於工作階段或電腦。
類型: | Int32 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |