Start-DscConfiguration

  • Referencia
Modul:
PSDesiredStateConfiguration

Konfigurációt alkalmaz a csomópontokra.

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

A Start-DscConfiguration parancsmag a csomópontokra alkalmazza a konfigurációt. A UseExisting paraméterrel való használat esetén a rendszer a célszámítógépen meglévő konfigurációt alkalmazza. Adja meg, hogy mely számítógépekre szeretne konfigurációt alkalmazni a számítógépnevek megadásával vagy a Common Information Model (CIM) munkamenetek használatával.

Alapértelmezés szerint ez a parancsmag létrehoz egy feladatot, és egy Feladat objektumot ad vissza. A háttérfeladatokkal kapcsolatos további információkért írja be a következőt Get-Help about_Jobs: . A parancsmag interaktív használatához adja meg a Wait paramétert.

Adja meg a Részletes paramétert annak részleteinek megtekintéséhez, hogy a parancsmag mit tesz a konfigurációs beállítások alkalmazásakor.

Példák

1. példa: Konfigurációs beállítások alkalmazása

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

Ez a parancs minden olyan számítógépre alkalmazza a konfigurációs beállításokat C:\DSC\Configurations\ , amelyek beállításai az adott mappában találhatók. A parancs feladatobjektumokat ad vissza minden üzembe helyezett célcsomóponthoz.

2. példa: Konfigurációs beállítások alkalmazása és várakozás a konfiguráció befejezésére

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

Ez a parancs a konfigurációt C:\DSC\Configurations\ a helyi számítógépre alkalmazza. A parancs feladatobjektumokat ad vissza minden olyan célcsomóponthoz, amely ebben az esetben csak a helyi számítógépen van üzembe helyezve. Ez a példa a Részletes paramétert adja meg. Ezért a parancs a folytatáskor üzeneteket küld a konzolnak. A parancs tartalmazza a Wait paramétert. Ezért nem használhatja a konzolt, amíg a parancs be nem fejezi az összes konfigurációs feladatot.

3. példa: Konfigurációs beállítások alkalmazása CIM-munkamenet használatával

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

Ez a példa egy megadott számítógépre alkalmazza a konfigurációs beállításokat. A példa létrehoz egy CIM-munkamenetet egy Server01 nevű számítógéphez a parancsmaggal való használatra. Másik lehetőségként hozzon létre egy CIM-munkamenetekből álló tömböt, amellyel a parancsmagot több megadott számítógépre alkalmazhatja.

Az első parancs létrehoz egy CIM-munkamenetet a New-CimSession parancsmag használatával, majd tárolja a CimSession objektumot a $Session változóban. A parancssor jelszó megadását kéri. További információért írja be a következőt: Get-Help NewCimSession.

A második parancs a konfigurációs beállításokat C:\DSC\Configurations alkalmazza a változóban $Session tárolt CimSession-objektumok által azonosított számítógépekre. Ebben a példában a változó csak a $Session Server01 nevű számítógép CIM-munkamenetét tartalmazza. A parancs alkalmazza a konfigurációt. A parancs feladatobjektumokat hoz létre minden konfigurált számítógéphez.

Paraméterek

-CimSession

Távoli munkamenetben vagy távoli számítógépen futtatja a parancsmagot. Adjon meg egy számítógépnevet vagy munkamenet-objektumot, például egy New-CimSession vagy Get-CimSession parancsmag kimenetét. Az alapértelmezett beállítás az aktuális munkamenet a helyi számítógépen.

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

-ComputerName

A számítógépnevek tömbjének megadása. Ez a paraméter korlátozza azokat a számítógépeket, amelyek konfigurációs dokumentumait a Path paraméterben a tömbben megadottakra korlátozza.

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

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-Credential

Megadja a célszámítógéphez tartozó felhasználónevet és jelszót PSCredential objektumként. PSCredential objektum beszerzéséhez használja a Get-Credential parancsmagot. További információért írja be a következőt: Get-Help Get-Credential.

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

-Force

Leállítja a célszámítógépen jelenleg futó konfigurációs műveletet, és megkezdi az új Start-Configuration műveletet. Ha a Helyi Configuration Manager RefreshMode tulajdonsága Lekérés értékre van állítva, a paraméter megadása leküldéses értékre módosítja.

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

-JobName

Egy feladat rövid nevét adja meg. Ha ezt a paramétert adja meg, a parancsmag feladatként fut, és egy Feladat objektumot ad vissza.

Alapértelmezés szerint Windows PowerShell hozzárendeli a JobN nevet, ahol az N egész szám.

Ha a Wait paramétert adja meg, ne adja meg ezt a paramétert.

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

-Path

A konfigurációs beállítások fájljait tartalmazó mappa fájlelérési útját adja meg. Ez a parancsmag közzéteszi és alkalmazza ezeket a konfigurációs beállításokat azokra a számítógépekre, amelyeken a megadott elérési út beállításfájljai találhatók. Minden célcsomópontnak a következő formátumú beállításfájllal kell rendelkeznie: <NetBIOS Name>.mof.

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

-ThrottleLimit

Megadja a parancsmag futtatásához létrehozható egyidejű műveletek maximális számát. Ha ezt a paramétert nem adja meg, vagy egy értéket 0 ad meg, akkor Windows PowerShell kiszámítja a parancsmag optimális szabályozási korlátját a számítógépen futó CIM-parancsmagok száma alapján. A szabályozási korlát csak az aktuális parancsmagra vonatkozik, a munkamenetre és a számítógépre nem.

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

-UseExisting

Azt jelzi, hogy ez a parancsmag a meglévő konfigurációt alkalmazza. A konfiguráció létezhet a célszámítógépen a Publish-DscConfiguration parancsmaggal Start-DscConfiguration történő közzététellel.

Mielőtt megad egy paramétert ehhez a parancsmaghoz, tekintse át az Windows PowerShell 5.0 újdonságai című cikkben található információkat.

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

-Wait

Azt jelzi, hogy a parancsmag blokkolja a konzolt, amíg be nem fejeződik az összes konfigurációs feladat.

Ha ezt a paramétert adja meg, ne adja meg a JobName paramétert.

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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