Dela via

Start-DscConfiguration

Modul:
PSDesiredStateConfiguration Module v1.1

Tillämpar konfiguration på noder.

Syntax

ComputerNameAndPathSet (Standard) 

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

CimSessionAndPathSet 

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

ComputerNameAndUseExistingSet 

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

CimSessionAndUseExistingSet 

Start-DscConfiguration
    -CimSession <CimSession[]>
    [-Wait]
    [-Force]
    [-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.

Parameteregenskaper

Typ:

CimSession[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CimSessionAndPathSet
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
CimSessionAndUseExistingSet
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:CN, Servernamn

Parameteruppsättningar

ComputerNameAndPathSet
Position:1
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ComputerNameAndUseExistingSet
Position:1
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Confirm

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:PSCredential
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ComputerNameAndPathSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ComputerNameAndUseExistingSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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-.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ComputerNameAndPathSet
Position:0
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
CimSessionAndPathSet
Position:0
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:Int32
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ComputerNameAndUseExistingSet
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
CimSessionAndUseExistingSet
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.