Test-DscConfiguration
語法
ComputerNameSet (預設值)
Test-DscConfiguration
[[-ComputerName] <String[]>]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-Detailed]
[<CommonParameters>]
ComputerNameAndPathSet
Test-DscConfiguration
[[-ComputerName] <String[]>]
[-Path] <String>
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-AsJob]
[<CommonParameters>]
ComputerNameAndReferenceConfigurationSet
Test-DscConfiguration
[[-ComputerName] <String[]>]
-ReferenceConfiguration <String>
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-AsJob]
[<CommonParameters>]
CimSessionAndPathSet
Test-DscConfiguration
[-Path] <String>
-CimSession <CimSession[]>
[-ThrottleLimit <Int32>]
[-AsJob]
[<CommonParameters>]
CimSessionAndReferenceConfigurationSet
Test-DscConfiguration
-CimSession <CimSession[]>
-ReferenceConfiguration <String>
[-ThrottleLimit <Int32>]
[-AsJob]
[<CommonParameters>]
CimSessionSet
Test-DscConfiguration
-CimSession <CimSession[]>
[-ThrottleLimit <Int32>]
[-AsJob]
[-Detailed]
[<CommonParameters>]
Description
Test-DscConfiguration Cmdlet 會測試節點上的實際組態是否符合所需的組態。 使用計算機名稱或 Common Information Model （CIM） 工作階段，指定要測試設定的電腦。 如果您未指定目標計算機，Cmdlet 會測試本機電腦的組態。
如果所需的和實際組態相符，Cmdlet 會傳回 'True' 的字串值。
否則，它會傳回 『False』 的字串值。
範例
範例 1：測試本機計算機的組態
Test-DscConfiguration
此命令會測試本機計算機的組態。
範例 2：測試指定計算機的組態
$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Test-DscConfiguration -CimSession $Session
此範例會從 CIM 會話指定的計算機測試組態。 此範例會為名為 Server01 的電腦建立 CIM 會話，以搭配 Cmdlet 使用。 或者，建立 CIM 會話陣列，以將 Cmdlet 套用至多個指定的電腦。
第一個命令會使用 New-CimSession Cmdlet 建立 CIM 會話，然後將 CimSession 物件儲存在 $Session 變數中。 命令會提示您輸入密碼。 如需詳細資訊，請輸入 Get-Help New-CimSession。
第二個命令會測試 CimSession 所識別之計算機的組態， 儲存在 $Session 變數中的物件，在此案例中為名為 Server01 的計算機。
範例 3：使用詳細結果測試組態
Test-DscConfiguration -ComputerName "Server01", "Server02", "Server03" -Detailed
此命令會測試 ComputerName 參數所指定之一組計算機的組態，並傳回包含整體狀態、處於所需狀態的資源、不符合所需狀態的資源和計算機名稱的詳細資訊。
範例 4：測試資料夾中指定的組態
Test-DscConfiguration -Path "C:\Dsc\Configurations"
此命令會測試 Path 參數所指定資料夾中定義的組態。
這些組態會針對一組計算機進行測試，每個計算機都是由組態檔的檔名所識別。
範例 5：測試檔案中指定的組態
Test-DscConfiguration -ReferenceConfiguration "C:\Dsc\Configurations\WebServer.mof" -ComputerName "Server01", "Server02", "Server03"
此命令會針對 ComputerName 參數所指定的一組計算機，測試檔案中定義的組態。
參數
-AsJob
表示此 Cmdlet 會以背景工作的形式執行命令。
如果您指定 AsJob 參數，命令會傳回代表作業的物件，然後顯示命令提示字元。 您可以繼續在會話中工作，直到作業完成為止。
作業會在本機計算機上建立，而遠端計算機的結果會自動傳回至本機計算機。 若要管理作業，請使用作業 Cmdlet。 若要取得作業結果，請使用 Receive-Job Cmdlet。
若要使用此參數，本機和遠端電腦必須設定為遠端，而且在 Windows Vista 和更新版本的 Windows 作業系統上，您必須使用 [以系統管理員身分執行] 選項開啟 Windows PowerShell。 如需詳細資訊，請參閱 about_Remote_Requirements。
如需 Windows PowerShell 背景工作的詳細資訊，請參閱 about_Jobs 和 about_Remote_Jobs。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-CimSession
在遠端會話或遠端電腦上執行 Cmdlet。 輸入計算機名稱或會話物件，例如 New-CimSession 或 Get-CimSession Cmdlet 的輸出。 預設為本機電腦上的目前會話。
參數屬性
參數集
CimSessionAndPathSet
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CimSessionAndReferenceConfigurationSet
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CimSessionSet
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ComputerName
指定此 Cmdlet 測試設定的電腦名稱陣列。 Cmdlet 會測試這些電腦 Path 參數所指定位置中的組態檔。
參數屬性
| 類型: | String[]
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 中國, 伺服器名稱 |
參數集
ComputerNameSet
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ComputerNameAndPathSet
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ComputerNameAndReferenceConfigurationSet
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Credential
指定目標計算機的使用者名稱和密碼，做為 PSCredential 物件。 若要取得 PSCredential 物件，請使用 Get-Credential Cmdlet。 如需詳細資訊，請輸入 Get-Help Get-Credential。
參數屬性
參數集
ComputerNameSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ComputerNameAndPathSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ComputerNameAndReferenceConfigurationSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Detailed
指出此 Cmdlet 會傳回比較組態檔與節點所需狀態的詳細結果。 結果包含資訊，例如整體狀態、處於預期狀態的資源、不符合預期狀態的資源，以及計算機名稱。
參數屬性
參數集
ComputerNameSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CimSessionSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Path
指定包含組態檔檔的資料夾路徑。 Cmdlet 會根據 ComputerName 或 CimSession 參數所指定的計算機狀態來測試組態。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ComputerNameAndPathSet
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CimSessionAndPathSet
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ReferenceConfiguration
指定組態檔檔的路徑。 此 Cmdlet 會根據 ComputerName 或 CimSession 參數所指定之電腦的實際狀態來測試組態。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ComputerNameAndReferenceConfigurationSet
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CimSessionAndReferenceConfigurationSet
| Position: | Named |
| 必要: | True |
| 來自管線的值: | 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。
