De Test-DscConfiguration cmdlet test of de werkelijke configuratie op de knooppunten overeenkomt met de gewenste configuratie. Geef op 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 een tekenreekswaarde van True.
Anders wordt een tekenreekswaarde van 'False' geretourneerd.
Voorbeelden
Voorbeeld 1: De configuratie voor de lokale computer testen
Test-DscConfiguration
Met deze opdracht wordt de configuratie voor de lokale computer getest.
Voorbeeld 2: Configuratie testen voor een opgegeven computer
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 cmdlet New-CimSession en slaat u vervolgens het CimSession--object op in de variabele $Session. De opdracht vraagt u om een wachtwoord. Typ Get-Help New-CimSessionvoor meer informatie.
Met de tweede opdracht wordt de configuratie getest voor de computers die zijn geïdentificeerd door de CimSession objecten die zijn opgeslagen in de variabele $Session, in dit geval de computer met de naam Server01.
Voorbeeld 3: Configuraties testen met gedetailleerde resultaten
Met deze opdracht worden configuraties getest voor een set computers die zijn opgegeven door de parameter ComputerName en wordt gedetailleerde informatie geretourneerd die de algehele status bevat, resources die zich in de gewenste status bevinden, resources die zich niet in de gewenste status en computernaam bevinden.
Voorbeeld 4: Configuraties testen die zijn opgegeven in een map
Met deze opdracht worden configuraties getest die zijn gedefinieerd in een map die is opgegeven door 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
Met deze opdracht wordt een configuratie getest die in een bestand is gedefinieerd op basis van een set computers die zijn opgegeven door de parameter ComputerName.
Parameters
-AsJob
Geeft aan dat met deze cmdlet de opdracht wordt uitgevoerd als achtergrondtaak.
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 de cmdlet Receive-Job om de taakresultaten op te halen.
Als u deze parameter wilt gebruiken, moeten de lokale en externe computers worden geconfigureerd voor externe communicatie, en op Windows Vista en latere versies van het Windows-besturingssysteem moet u Windows PowerShell openen met de optie Als administrator uitvoeren. Zie about_Remote_Requirementsvoor meer informatie.
De cmdlet wordt uitgevoerd in een externe sessie of op een externe computer. Voer een computernaam of een sessieobject in, zoals de uitvoer van een New-CimSession of Get-CimSession cmdlet. De standaardwaarde is de huidige sessie op de lokale computer.
Hiermee geeft u een matrix van computernamen waarop deze cmdlet de configuratie test. De cmdlet test het configuratiedocument op de locatie die is opgegeven door de parameter Path op deze computers.
Hiermee geeft u een gebruikersnaam en wachtwoord, als een PSCredential-object, voor de doelcomputer. Als u een PSCredential--object wilt verkrijgen, gebruikt u de cmdlet Get-Credential. Typ Get-Help Get-Credentialvoor meer informatie.
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 computernaam.
Hiermee geeft u het pad van een map die configuratiedocumentbestanden bevat. De cmdlet test de configuratie op basis van de gewenste status van computers die zijn opgegeven door de ComputerName of CimSession parameter.
Hiermee geeft u het pad van het configuratiedocumentbestand. Met deze cmdlet wordt de configuratie getest op basis van de werkelijke status van computers die zijn opgegeven door de ComputerName- of CimSession-parameter.
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 als er 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.
De bron voor deze inhoud vindt u op GitHub, waar u ook problemen en pull-aanvragen kunt maken en controleren. Bekijk onze gids voor inzenders voor meer informatie.
