Get-DscConfiguration

  • 參考
模組:
PSDesiredStateConfiguration

取得節點的目前組態。

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