Delen via

Test-DscConfiguration

  • Referentie
Module:
PSDesiredStateConfiguration

Test of de werkelijke configuratie op de knooppunten overeenkomt met de gewenste configuratie.

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

De Test-DscConfiguration cmdlet test of de werkelijke configuratie op de knooppunten overeenkomt met de gewenste configuratie. Geef op voor welke computers u configuraties wilt testen met behulp van computernamen of CIM-sessies (Common Information Model). Als u geen doelcomputer opgeeft, test de cmdlet de configuratie van de lokale computer.

Als de gewenste en werkelijke configuraties overeenkomen, retourneert de cmdlet de tekenreekswaarde True. Anders wordt de tekenreekswaarde 'False' geretourneerd.

Voorbeelden

Voorbeeld 1: Testconfiguratie voor de lokale computer

Test-DscConfiguration

Met deze opdracht wordt de configuratie voor de lokale computer getest.

Voorbeeld 2: Testconfiguratie voor een opgegeven computer

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

In dit voorbeeld wordt de configuratie getest vanaf een computer die is opgegeven door een CIM-sessie. In het voorbeeld wordt een CIM-sessie gemaakt voor een computer met de naam Server01 voor gebruik met de cmdlet. U kunt ook een matrix van CIM-sessies maken om de cmdlet toe te passen op meerdere opgegeven computers.

Met de eerste opdracht maakt u een CIM-sessie met behulp van de New-CimSession cmdlet en slaat u vervolgens het CimSession-object op in de $Session variabele. De opdracht vraagt u om een wachtwoord. Typ Get-Help New-CimSession voor meer informatie.

De tweede opdracht test de configuratie voor de computers die worden geïdentificeerd door de CimSession-objecten die zijn opgeslagen in de $Session variabele, in dit geval de computer met de naam Server01.

Voorbeeld 3: Configuraties testen met gedetailleerde resultaten

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

Met deze opdracht worden configuraties getest voor een set computers die is opgegeven door de computernaamparameter en wordt gedetailleerde informatie geretourneerd, waaronder de algehele status, resources die zich in de gewenste status bevinden, resources die niet de gewenste status hebben en de computernaam.

Voorbeeld 4: Configuraties testen die zijn opgegeven in een map

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

Met deze opdracht worden configuraties getest die zijn gedefinieerd in een map die is opgegeven met de parameter Path . De configuraties worden getest op basis van een set computers, die elk worden geïdentificeerd door de bestandsnaam van het configuratiebestand.

Voorbeeld 5: Configuraties testen die zijn opgegeven in een bestand

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

Met deze opdracht wordt een configuratie getest die in een bestand is gedefinieerd op basis van een set computers die is opgegeven met de parameter ComputerName .

Parameters

-AsJob

Geeft aan dat deze cmdlet de opdracht als een achtergrondtaak uitvoert.

Als u de parameter AsJob opgeeft, retourneert de opdracht een object dat de taak vertegenwoordigt en wordt vervolgens de opdrachtprompt weergegeven. U kunt in de sessie blijven werken totdat de taak is voltooid. De taak wordt gemaakt op de lokale computer en de resultaten van externe computers worden automatisch geretourneerd naar de lokale computer. Gebruik de taak-cmdlets om de taak te beheren. Gebruik Receive-Job de cmdlet om de taakresultaten op te halen.

Als u deze parameter wilt gebruiken, moeten de lokale en externe computers zijn geconfigureerd voor externe communicatie. In Windows Vista en latere versies van het Windows-besturingssysteem moet u Windows PowerShell openen met de optie Als administrator uitvoeren. Zie about_Remote_Requirements voor meer informatie.

Zie about_Jobs en about_Remote_Jobs voor meer informatie over Windows PowerShell achtergrondtaken.

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

-CimSession

Voert de cmdlet uit in een externe sessie of op een externe computer. Voer een computernaam of een sessieobject in, zoals de uitvoer van een cmdlet New-CimSession of Get-CimSession . De standaardinstelling is de huidige sessie op de lokale computer.

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

-ComputerName

Hiermee geeft u een matrix met computernamen op waarop deze cmdlet de configuratie test. De cmdlet test het configuratiedocument op de locatie die is opgegeven door de padparameter naar deze computers.

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

-Credential

Hiermee geeft u een gebruikersnaam en wachtwoord, als een PSCredential-object , voor de doelcomputer. Gebruik de Get-Credential cmdlet om een PSCredential-object te verkrijgen. Typ Get-Help Get-Credential voor meer informatie.

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

-Detailed

Geeft aan dat deze cmdlet een gedetailleerd resultaat retourneert van het vergelijken van het configuratiedocument met de gewenste status van de knooppunten. Het resultaat bevat informatie zoals de algehele status, resources die de gewenste status hebben, resources die niet de gewenste status hebben en de computernaam.

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

-Path

Hiermee geeft u het pad op van een map die configuratiedocumentbestanden bevat. De cmdlet test de configuratie op basis van de gewenste status van computers die zijn opgegeven door de computernaam of CimSession parameter.

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

-ReferenceConfiguration

Hiermee geeft u het pad van het configuratiedocumentbestand op. Met deze cmdlet wordt de configuratie getest op basis van de werkelijke status van computers die zijn opgegeven door de parameter ComputerName of CimSession .

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

-ThrottleLimit

Hiermee geeft u het maximum aantal gelijktijdige bewerkingen op dat kan worden ingesteld om de cmdlet uit te voeren. Als deze parameter wordt weggelaten of een waarde van 0 wordt ingevoerd, berekent Windows PowerShell een optimale beperkingslimiet voor de cmdlet op basis van het aantal CIM-cmdlets dat op de computer wordt uitgevoerd. De beperkingslimiet is alleen van toepassing op de huidige cmdlet, niet op de sessie of op de computer.

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