Start-DscConfiguration

  • Referens
Modul:
PSDesiredStateConfiguration

Tillämpar konfiguration på noder.

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

Cmdleten Start-DscConfiguration tillämpar konfiguration på noder. När den används med parametern UseExisting tillämpas den befintliga konfigurationen på måldatorn. Ange vilka datorer som du vill tillämpa konfigurationen på genom att ange datornamn eller med hjälp av CIM-sessioner (Common Information Model).

Som standard skapar den här cmdleten ett jobb och returnerar ett jobbobjekt . Om du vill ha mer information om bakgrundsjobb skriver du Get-Help about_Jobs. Om du vill använda den här cmdleten interaktivt anger du parametern Vänta .

Ange den utförliga parametern för att se information om vad cmdleten gör när konfigurationsinställningarna tillämpas.

Exempel

Exempel 1: Tillämpa konfigurationsinställningar

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

Det här kommandot tillämpar konfigurationsinställningarna från C:\DSC\Configurations\ på alla datorer som har inställningar i mappen. Kommandot returnerar jobbobjekt för varje målnod som distribueras till.

Exempel 2: Tillämpa konfigurationsinställningar och vänta tills konfigurationen har slutförts

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

Det här kommandot tillämpar konfigurationen från C:\DSC\Configurations\ på den lokala datorn. Kommandot returnerar jobbobjekt för varje målnod som distribueras till, i det här fallet, bara den lokala datorn. Det här exemplet anger parametern Verbose . Därför skickar kommandot meddelanden till konsolen när den fortsätter. Kommandot innehåller parametern Vänta . Därför kan du inte använda -konsolen förrän kommandot har slutfört alla konfigurationsuppgifter.

Exempel 3: Tillämpa konfigurationsinställningar med hjälp av en CIM-session

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

Det här exemplet tillämpar konfigurationsinställningar på en angiven dator. I exemplet skapas en CIM-session för en dator med namnet Server01 för användning med cmdleten. Du kan också skapa en matris med CIM-sessioner för att tillämpa cmdleten på flera angivna datorer.

Det första kommandot skapar en CIM-session med hjälp av cmdleten New-CimSession och lagrar sedan CimSession-objektet i variabeln $Session . Kommandot uppmanar dig att ange ett lösenord. För mer information ange Get-Help NewCimSession.

Det andra kommandot tillämpar konfigurationsinställningarna från C:\DSC\Configurations på de datorer som identifieras av CimSession-objekten som lagras i variabeln $Session . I det här exemplet innehåller variabeln $Session endast en CIM-session för datorn med namnet Server01. Kommandot tillämpar konfigurationen. Kommandot skapar jobbobjekt för varje konfigurerad dator.

Parametrar

-CimSession

Kör cmdleten i en fjärrsession eller på en fjärrdator. Ange ett datornamn eller ett sessionsobjekt, till exempel utdata från cmdleten New-CimSession eller Get-CimSession . Standardinställningen är den aktuella sessionen på den lokala datorn.

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

-ComputerName

Anger en matris med datornamn. Den här parametern begränsar de datorer som har konfigurationsdokument i parametern Sökväg till de som anges i matrisen.

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-Credential

Anger ett användarnamn och lösenord som ett PSCredential-objekt för måldatorn. Om du vill hämta ett PSCredential-objekt använder du cmdleten Get-Credential . För mer information ange Get-Help Get-Credential.

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

-Force

Stoppar konfigurationsåtgärden som körs på måldatorn och påbörjar den nya Start-Configuration åtgärden. Om egenskapen RefreshMode för den lokala Configuration Manager är inställd på Pull ändrar du den här parametern till Push.

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

-JobName

Anger ett eget namn för ett jobb. Om du anger den här parametern körs cmdleten som ett jobb och returnerar ett jobbobjekt .

Som standard tilldelar Windows PowerShell namnet JobN där N är ett heltal.

Om du anger parametern Vänta ska du inte ange den här parametern.

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

-Path

Anger en filsökväg för en mapp som innehåller konfigurationsinställningsfiler. Den här cmdleten publicerar och tillämpar dessa konfigurationsinställningar på datorer som har inställningsfiler i den angivna sökvägen. Varje målnod måste ha en inställningsfil med följande format: <NetBIOS Name>.mof.

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

-ThrottleLimit

Anger det maximala antalet samtidiga åtgärder som kan upprättas för att köra cmdleten. Om den här parametern utelämnas eller ett värde anges 0 beräknar Windows PowerShell en optimal begränsningsgräns för cmdleten baserat på antalet CIM-cmdletar som körs på datorn. Begränsningsgränsen gäller endast för den aktuella cmdleten, inte för sessionen eller datorn.

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

-UseExisting

Anger att den här cmdleten tillämpar den befintliga konfigurationen. Konfigurationen kan finnas på måldatorn genom att använda Start-DscConfiguration eller genom publicering med hjälp av cmdleten Publish-DscConfiguration.

Innan du anger den här parametern för den här cmdleten läser du informationen i Nyheter i Windows PowerShell 5.0.

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

-Wait

Anger att cmdleten blockerar konsolen tills den har slutfört alla konfigurationsuppgifter.

Om du anger den här parametern ska du inte ange parametern JobName .

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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