Cmdleten Test-DscConfiguration testar om den faktiska konfigurationen på noderna matchar den önskade konfigurationen. Ange vilka datorer som du vill testa konfigurationer för 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 ett strängvärde av "False".
Exempel
Exempel 1: Testa konfigurationen för den lokala datorn
Test-DscConfiguration
Det här kommandot testar konfigurationen för den lokala datorn.
Det här exemplet testar konfigurationen från en dator som anges av en CIM-session. I exemplet skapas 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 objektet CimSession i variabeln $Session. Kommandot uppmanar dig att ange ett lösenord. Om du vill ha mer information skriver du Get-Help New-CimSession.
Det andra kommandot testar konfigurationen för datorerna som identifieras av CimSession objekt som lagras i variabeln $Session, i det här fallet datorn med namnet Server01.
Exempel 3: Testa konfigurationer med detaljerade resultat
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: Testkonfigurationer som anges i en mapp
Det här kommandot testar konfigurationer som definieras i en mapp som anges av parametern Path.
Konfigurationerna testas mot en uppsättning datorer som var och en identifieras med filnamnet för konfigurationsfilen.
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 den här cmdleten 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 cmdletarna Jobb. Använd cmdleten Receive-Job för att hämta jobbresultatet.
Om du vill använda den här parametern måste de lokala datorerna och fjärrdatorerna 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.
Kör cmdleten i en fjärrsession eller på en fjärrdator. Ange ett datornamn eller ett sessionsobjekt, till exempel utdata från en New-CimSession- eller Get-CimSession cmdlet. Standardvärdet är den aktuella sessionen på den lokala datorn.
Anger en matris med datornamn som den här cmdleten testar konfigurationen på. Cmdleten testar konfigurationsdokumentet på den plats som anges av parametern Path till dessa datorer.
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. Om du vill ha mer information skriver du Get-Help Get-Credential.
Anger att den här cmdleten returnerar ett detaljerat resultat av att jämföra konfigurationsdokumentet med nodernas önskade tillstånd. 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.
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.
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.
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 på 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 på datorn.
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
Källan för det här innehållet finns på GitHub, där du även kan skapa och granska ärenden och pull-begäranden. Se vår deltagarguide för mer information.
