Test-DscConfiguration

  • Referens
Modul:
PSDesiredStateConfiguration

Testar om den faktiska konfigurationen på noderna matchar den önskade konfigurationen.

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

Cmdleten Test-DscConfiguration testar om den faktiska konfigurationen på noderna matchar den önskade konfigurationen. Ange för vilka datorer du vill testa konfigurationer med hjälp av datornamn eller CIM-sessioner (Common Information Model). Om du inte anger en måldator testar cmdleten konfigurationen av den lokala datorn.

Om de önskade och faktiska konfigurationerna matchar returnerar cmdleten strängvärdet True. Annars returneras strängvärdet False.

Exempel

Exempel 1: Testa konfigurationen för den lokala datorn

Test-DscConfiguration

Det här kommandot testar konfigurationen för den lokala datorn.

Exempel 2: Testa konfigurationen för en angiven dator

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Test-DscConfiguration -CimSession $Session

Det här exemplet testar konfigurationen från en dator som anges av en CIM-session. Exemplet skapar en CIM-session för en dator med namnet Server01 för användning med cmdleten . Du kan också skapa en matris med CIM-sessioner för att tillämpa cmdleten på flera angivna datorer.

Det första kommandot skapar en CIM-session med hjälp av cmdleten New-CimSession och lagrar sedan CimSession-objektet i variabeln $Session . Kommandot uppmanar dig att ange ett lösenord. För mer information ange Get-Help New-CimSession.

Det andra kommandot testar konfigurationen för de datorer som identifieras av CimSession-objekten som lagras i variabeln $Session , i det här fallet datorn med namnet Server01.

Exempel 3: Testa konfigurationer med detaljerade resultat

Test-DscConfiguration -ComputerName "Server01", "Server02", "Server03" -Detailed

Det här kommandot testar konfigurationer för en uppsättning datorer som anges av parametern ComputerName och returnerar detaljerad information som innehåller det övergripande tillståndet, resurser som är i önskat tillstånd, resurser som inte har önskat tillstånd och datornamn.

Exempel 4: Testa konfigurationer som anges i en mapp

Test-DscConfiguration -Path "C:\Dsc\Configurations"

Det här kommandot testar konfigurationer som definieras i en mapp som anges av parametern Path . Konfigurationerna testas mot en uppsättning datorer som vart och ett identifieras med filnamnet för konfigurationsfilen.

Exempel 5: Testa konfigurationer som anges i en fil

Test-DscConfiguration -ReferenceConfiguration "C:\Dsc\Configurations\WebServer.mof" -ComputerName "Server01", "Server02", "Server03"

Det här kommandot testar en konfiguration som definierats i en fil mot en uppsättning datorer som anges av parametern ComputerName .

Parametrar

-AsJob

Anger att denna cmdlet kör kommandot som ett bakgrundsjobb.

Om du anger parametern AsJob returnerar kommandot ett objekt som representerar jobbet och visar sedan kommandotolken. Du kan fortsätta att arbeta i sessionen tills jobbet har slutförts. Jobbet skapas på den lokala datorn och resultatet från fjärrdatorerna returneras automatiskt till den lokala datorn. Om du vill hantera jobbet använder du jobb-cmdletar. Använd cmdleten för att hämta jobbresultatet Receive-Job .

Om du vill använda den här parametern måste lokala datorer och fjärrdatorer konfigureras för fjärrkommunikation, och i Windows Vista och senare versioner av Windows-operativsystemet måste du öppna Windows PowerShell med alternativet Kör som administratör. Mer information finns i about_Remote_Requirements.

Mer information om Windows PowerShell bakgrundsjobb finns i about_Jobs och about_Remote_Jobs.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CimSession

Kör cmdleten i en fjärrsession eller på en fjärrdator. Ange ett datornamn eller ett sessionsobjekt, till exempel utdata från cmdleten New-CimSession eller Get-CimSession . Standardinställningen är den aktuella sessionen på den lokala datorn.

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Anger en matris med datornamn där den här cmdleten testar konfigurationen. Cmdleten testar konfigurationsdokumentet på den plats som anges av parametern Sökväg till dessa datorer.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Credential

Anger ett användarnamn och lösenord, som ett PSCredential-objekt , för måldatorn. Om du vill hämta ett PSCredential-objekt använder du cmdleten Get-Credential . För mer information ange Get-Help Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Detailed

Anger att denna cmdlet returnerar ett detaljerat resultat av att jämföra konfigurationsdokumentet med det önskade tillståndet för noderna. Resultatet innehåller information som övergripande tillstånd, resurser som är i önskat tillstånd, resurser som inte är i önskat tillstånd och datornamn.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Anger sökvägen till en mapp som innehåller konfigurationsdokumentfiler. Cmdleten testar konfigurationen mot det önskade tillståndet för datorer som anges av parametern ComputerName eller CimSession .

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ReferenceConfiguration

Anger sökvägen till konfigurationsdokumentfilen. Den här cmdleten testar konfigurationen mot det faktiska tillståndet för datorer som anges av parametern ComputerName eller CimSession .

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

Anger det maximala antalet samtidiga åtgärder som kan upprättas för att köra cmdleten. Om den här parametern utelämnas eller ett värde för 0 anges beräknar Windows PowerShell en optimal begränsningsgräns för cmdleten baserat på antalet CIM-cmdletar som körs på datorn. Begränsningsgränsen gäller endast för den aktuella cmdleten, inte för sessionen eller datorn.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False