Test-DscConfiguration

  • 參考
模組:
PSDesiredStateConfiguration

測試節點上的實際設定是否符合預期設定。

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