Get-DscConfiguration
取得節點的目前組態。
語法
Default (預設值)
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 |
| 預設值: | 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 |
-ThrottleLimit
指定可以建立以執行 Cmdlet 的並行作業數目上限。 如果省略此參數或輸入 0 的值，則 Windows PowerShell 會根據計算機上執行的 CIM Cmdlet 數目，計算 Cmdlet 的最佳節流限制。 節流限制僅適用於目前的 Cmdlet，不適用於工作階段或電腦。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | 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。
