Delen via

Start-DscConfiguration

  • Referentie
Module:
PSDesiredStateConfiguration

Hiermee past u configuratie toe op knooppunten.

Syntaxis

Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

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.

Voorbeelden

Voorbeeld 1: Configuratie-instellingen toepassen

Start-DscConfiguration -Path "C:\DSC\Configurations\"

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

Start-DscConfiguration -Path "C:\DSC\Configurations\" -Wait -Verbose

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

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Start-DscConfiguration -Path "C:\DSC\Configurations\" -CimSession $Session

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.

Type:CimSession[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ComputerName

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.

Type:String[]
Aliassen:CN, ServerName
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

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.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

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-.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobName

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.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Path

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.

Type:String
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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 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.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UseExisting

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.

Voordat u deze parameter voor deze cmdlet opgeeft, raadpleegt u de informatie in Wat is er nieuw in Windows PowerShell 5.0.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Wait

Geeft aan dat de cmdlet de console blokkeert totdat alle configuratietaken zijn voltooid.

Als u deze parameter opgeeft, geeft u de parameter JobName niet op.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False