Dela via

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 genom att använda CIM-sessioner (Common Information Model).

Som standard skapar den här cmdleten ett jobb och returnerar ett jobb objekt. 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 Wait.

Ange parametern Utförlig 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 Jobb objekt 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 Jobb objekt för varje målnod som distribueras till, i det här fallet, bara den lokala datorn. Det här exemplet anger parametern Utförlig. Därför skickar kommandot meddelanden till konsolen när det fortsätter. Kommandot innehåller parametern Wait. 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 objektet CimSession i variabeln $Session. Kommandot uppmanar dig att ange ett lösenord. Om du vill ha mer information skriver du Get-Help NewCimSession.

Det andra kommandot tillämpar konfigurationsinställningarna från C:\DSC\Configurations på datorerna som identifieras av CimSession objekt 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 Job-objekt 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 en New-CimSession- eller Get-CimSession cmdlet. Standardvärdet är den aktuella sessionen på den lokala datorn.

Typ:CimSession[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ComputerName

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

Typ:String[]
Alias:CN, ServerName
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Confirm

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

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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. Om du vill ha mer information skriver du Get-Help Get-Credential.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 Job-objekt.

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

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Path

Anger en filsökväg för en mapp som innehåller konfigurationsinställningar. 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.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 på 0 anges 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 på datorn.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UseExisting

Anger att den här cmdleten tillämpar den befintliga konfigurationen. Konfigurationen kan finnas på måldatorn med hjälp av 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.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False