Test-DscConfiguration
測試節點上的實際設定是否符合預期設定。
Syntax
Test-DscConfiguration
[[-ComputerName] <String[]>]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-Detailed]
[<CommonParameters>] Test-DscConfiguration
[[-ComputerName] <String[]>]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-Path] <String>
[<CommonParameters>] Test-DscConfiguration
[[-ComputerName] <String[]>]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-AsJob]
-ReferenceConfiguration <String>
[<CommonParameters>] Test-DscConfiguration
[-ThrottleLimit <Int32>]
-CimSession <CimSession[]>
[-AsJob]
[-Path] <String>
[<CommonParameters>] Test-DscConfiguration
[-ThrottleLimit <Int32>]
-CimSession <CimSession[]>
[-AsJob]
-ReferenceConfiguration <String>
[<CommonParameters>] Test-DscConfiguration
[-ThrottleLimit <Int32>]
-CimSession <CimSession[]>
[-AsJob]
[-Detailed]
[<CommonParameters>] Description
Cmdlet 會 Test-DscConfiguration 測試節點上的實際設定是否符合所需的設定。 使用電腦名稱或通用訊息模型 (CIM) 工作階段，來指定您想要測試設定的電腦。 如果您沒有指定目標電腦，此 Cmdlet 會測試本機電腦的設定。
如果所需的和實際組態相符，Cmdlet 會傳回 'True' 的字串值。 否則，它會傳回 'False' 的字串值。
範例
範例 1：測試本機電腦的設定
Test-DscConfiguration此命令會測試本機電腦的設定。
範例 2：測試指定電腦的設定
$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Test-DscConfiguration -CimSession $Session這個範例會測試 CIM 工作階段所指定之電腦上的設定。 這個範例會針對名為 Server01 的電腦，建立一個搭配此 Cmdlet 使用的 CIM 工作階段。 或者，建立一個 CIM 工作階段的陣列，以便將該 Cmdlet 套用到多部指定的電腦。
第一個命令會使用 New-CimSession Cmdlet 建立 CIM 會話，然後將 CimSession 物件儲存在變數中 $Session 。 此命令會提示您輸入密碼。 如需詳細資訊，請鍵入 Get-Help New-CimSession。
第二個命令會測試儲存在變數中 $SessionCimSession物件所識別之電腦的組態，在此案例中為名為 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 參數，此命令就會傳回代表工作的物件，然後顯示命令提示字元。 您可以繼續在工作階段中運作，直到工作完成。
工作會在本機電腦上建立，而來自遠端電腦的結果則會自動傳回到本機電腦。 若要管理工作，請使用各項 Job Cmdlet。 若要取得作業結果，請使用 Receive-Job Cmdlet。
若要使用這個參數，本機電腦和遠端電腦必須針對遠端執行功能進行設定，並且在 Windows Vista 和更新版本的 Windows 作業系統上，您必須使用 [以系統管理員身分執行] 選項來開啟 Windows PowerShell。 如需詳細資訊，請參閱about_Remote_Requirements。
如需背景工作Windows PowerShell的詳細資訊，請參閱about_Jobs和about_Remote_Jobs。
| 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[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ComputerName
指定此 Cmdlet 測試設定所在的電腦名稱陣列。 此 Cmdlet 會在 Path 參數所指定的位置中，對這些電腦測試設定文件。
| Type: | String[] |
| Aliases: | CN, ServerName |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Credential
指定目標電腦的使用者名稱和密碼，做為 PSCredential 物件。 若要取得 PSCredential 物件，請使用 Get-Credential Cmdlet。 如需詳細資訊，請鍵入 Get-Help Get-Credential。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Detailed
指出此 Cmdlet 會傳回比較設定文件與節點預期狀態的詳細結果。 結果包括整體狀態、處於預期狀態的資源、未處於預期狀態的資源，以及電腦名稱等資訊。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
指定包含設定文件檔的資料夾路徑。 此 Cmdlet 會針對 ComputerName 或 CimSession 參數所指定的電腦預期狀態測試設定。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReferenceConfiguration
指定設定文件檔案的路徑。 此 Cmdlet 會針對 ComputerName 或 CimSession 參數所指定的電腦實際狀態測試設定。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
