De cmdlet Start-DscConfiguration past configuratie toe op knooppunten. Wanneer deze wordt gebruikt met de parameter UseExisting, wordt de bestaande configuratie op de doelcomputer toegepast. Geef op op welke computers u de configuratie wilt toepassen door computernamen of CIM-sessies (Common Information Model) op te geven.
Deze cmdlet maakt standaard een taak en retourneert een Job-object. Typ Get-Help about_Jobsvoor meer informatie over achtergrondtaken. Als u deze cmdlet interactief wilt gebruiken, geeft u de parameter Wait op.
Geef de uitgebreide parameter op om details te zien van wat de cmdlet doet wanneer configuratie-instellingen worden toegepast.
Met deze opdracht worden de configuratie-instellingen van C:\DSC\Configurations\ toegepast op elke computer met instellingen in die map. De opdracht retourneert Job-objecten voor elk doelknooppunt dat is geïmplementeerd.
Voorbeeld 2: Configuratie-instellingen toepassen en wachten tot de configuratie is voltooid
Met deze opdracht wordt de configuratie van C:\DSC\Configurations\ op de lokale computer toegepast. De opdracht retourneert taak--objecten voor elk doelknooppunt dat is geïmplementeerd op, in dit geval alleen de lokale computer. In dit voorbeeld wordt de uitgebreide parameter opgegeven. Daarom verzendt de opdracht berichten naar de console terwijl deze wordt voortgezet. De opdracht bevat de parameter Wait. Daarom kunt u de console pas gebruiken als de opdracht alle configuratietaken heeft voltooid.
Voorbeeld 3: Configuratie-instellingen toepassen met behulp van een CIM-sessie
In dit voorbeeld worden configuratie-instellingen toegepast op een opgegeven computer. 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 NewCimSessionvoor meer informatie.
Met de tweede opdracht worden de configuratie-instellingen van C:\DSC\Configurations toegepast op de computers die zijn geïdentificeerd door de CimSession objecten die zijn opgeslagen in de $Session variabele. In dit voorbeeld bevat de variabele $Session alleen een CIM-sessie voor de computer met de naam Server01. Met de opdracht wordt de configuratie toegepast. Met de opdracht maakt u objecten voor elke geconfigureerde computer.
Parameters
-CimSession
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. Met deze parameter worden de computers met configuratiedocumenten in de parameter Path beperkt tot computers die zijn opgegeven in de matrix.
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.
Hiermee stopt u de configuratiebewerking die momenteel op de doelcomputer wordt uitgevoerd en wordt de nieuwe Start-Configuration bewerking gestart. Als de eigenschap RefreshMode van Local Configuration Manager is ingesteld op Pull-, wordt deze parameter gewijzigd in Push-.
Hiermee geeft u een beschrijvende naam voor een taak. Als u deze parameter opgeeft, wordt de cmdlet uitgevoerd als een taak en wordt een Job-object geretourneerd.
Standaard wijst Windows PowerShell de naam JobN toe waarbij N een geheel getal is.
Als u de parameter Wait opgeeft, geeft u deze parameter niet op.
Hiermee geeft u een bestandspad op van een map die configuratie-instellingenbestanden bevat. Met deze cmdlet worden deze configuratie-instellingen gepubliceerd en toegepast op computers met instellingenbestanden in het opgegeven pad. Elk doelknooppunt moet een instellingenbestand van de volgende indeling hebben: <NetBIOS Name>.mof.
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.
Geeft aan dat deze cmdlet de bestaande configuratie toepast. De configuratie kan op de doelcomputer bestaan door gebruik te maken van Start-DscConfiguration of door publicatie te gebruiken met behulp van de Publish-DscConfiguration-cmdlet.
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.
