Delen via

Start-DscConfiguration

  • Referentie
Module:
PSDesiredStateConfiguration

Configuratie toepassen op knooppunten.

Syntax

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 Start-DscConfiguration cmdlet past configuratie toe op knooppunten. Bij gebruik met de parameter UseExisting wordt de bestaande configuratie op de doelcomputer toegepast. Geef op welke computers u configuratie wilt toepassen door computernamen op te geven of door CIM-sessies (Common Information Model) te gebruiken.

Deze cmdlet maakt standaard een taak en retourneert een Job-object . Typ voor meer informatie over achtergrondtaken Get-Help about_Jobs. Als u deze cmdlet interactief wilt gebruiken, geeft u de parameter Wait op.

Geef de parameter Uitgebreid 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 Taakobjecten 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\ toegepast op de lokale computer. De opdracht retourneert Taakobjecten voor elk doelknooppunt dat is geïmplementeerd op, in dit geval alleen de lokale computer. In dit voorbeeld wordt de parameter Uitgebreid opgegeven. Daarom verzendt de opdracht berichten naar de console terwijl deze wordt uitgevoerd. De opdracht bevat de parameter Wait . Daarom kunt u de console niet gebruiken totdat 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 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 NewCimSession voor meer informatie.

Met de tweede opdracht worden de configuratie-instellingen van C:\DSC\Configurations toegepast op de computers die worden geïdentificeerd door de CimSession-objecten die zijn opgeslagen in de $Session variabele. In dit voorbeeld bevat de $Session variabele alleen een CIM-sessie voor de computer met de naam Server01. Met de opdracht wordt de configuratie toegepast. Met de opdracht worden taakobjecten voor elke geconfigureerde computer gemaakt.

Parameters

-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 van computernamen. Met deze parameter worden de computers met configuratiedocumenten in de parameter Path beperkt tot de computers die zijn opgegeven in de matrix.

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
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

-Force

Stopt de configuratiebewerking die momenteel wordt uitgevoerd op de doelcomputer en start de nieuwe Start-Configuration bewerking. Als de eigenschap RefreshMode van de lokale Configuration Manager is ingesteld op Pull, wordt deze parameter gewijzigd in Push als u deze parameter opgeeft.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 taakobject geretourneerd.

Standaard wijst Windows PowerShell de naam JobN toe waarbij N een geheel getal is.

Als u de parameter Wait opgeeft, moet u deze parameter niet opgeven.

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

-Path

Hiermee geeft u een bestandspad op van een map die bestanden met configuratie-instellingen bevat. Met deze cmdlet worden deze configuratie-instellingen gepubliceerd en toegepast op computers met instellingenbestanden in het opgegeven pad. Elk doelknooppunt moet een instellingenbestand met de volgende indeling hebben: <NetBIOS Name>.mof.

Type:String
Position:0
Default value:None
Required:False
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

-UseExisting

Geeft aan dat deze cmdlet de bestaande configuratie toepast. De configuratie kan bestaan op de doelcomputer door uit te voeren met behulp van Start-DscConfiguration of door publicatie met behulp van de cmdlet Publish-DscConfiguration.

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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Wait

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

Als u deze parameter opgeeft, moet u de parameter JobName niet opgeven.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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