Megosztás a következőn keresztül:

Start-DscConfiguration

Modul:
PSDesiredStateConfiguration Module v1.1

A konfigurációt a csomópontokra alkalmazza.

Syntax

ComputerNameAndPathSet (Alapértelmezett) 

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

A Start-DscConfiguration parancsmag a csomópontokra alkalmazza a konfigurációt. Ha a UseExisting paraméterrel használja, a rendszer a célszámítógép meglévő konfigurációjá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.

Ez a parancsmag alapértelmezés szerint létrehoz egy feladatot, és visszaad egy Feladat objektumot. A háttérfeladatokkal kapcsolatos további információkért írja be a Get-Help about_Jobs. A parancsmag interaktív használatához adja meg a Wait paramétert.

Adja meg a Részletes paramétert a parancsmag konfigurációs beállítások alkalmazásakor végzett műveleteinek részletes megtekintéséhez.

Példák

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

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

Ez a parancs az C:\DSC\Configurations\ konfigurációs beállításait alkalmazza minden olyan számítógépre, amelynek a mappájában vannak beállítások. A parancs Feladat objektumokat 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 C:\DSC\Configurations\ konfigurációját alkalmazza a helyi számítógépre. A parancs Feladat objektumokat 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 az Részletes paramétert adja meg. Ezért a parancs a folytatás során ü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 is alkalmazhatja.

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

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

Paraméterek

-CimSession

A parancsmagot távoli munkamenetben vagy távoli számítógépen futtatja. 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 az aktuális munkamenet a helyi számítógépen.

Paramétertulajdonságok

Típus:

CimSession[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

CimSessionAndPathSet
Position:Named
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
CimSessionAndUseExistingSet
Position:Named
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-ComputerName

A számítógépnevek tömbjének megadása. Ez a paraméter a Elérési út paraméterben található konfigurációs dokumentumokat a tömbben megadott számítógépekre korlátozza.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Kína, Kiszolgálónév

Paraméterkészletek

ComputerNameAndPathSet
Position:1
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
ComputerNameAndUseExistingSet
Position:1
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Cf

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Credential

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

Paramétertulajdonságok

Típus:PSCredential
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

ComputerNameAndPathSet
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
ComputerNameAndUseExistingSet
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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 konfigurációkezelő RefreshMode tulajdonsága a Lekérésesvan beállítva, a paraméter megadása Leküldésesértékre módosítja.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

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

Ha a Várakozás paramétert adja meg, ne adja meg ezt a paramétert.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

ComputerNameAndPathSet
Position:0
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
CimSessionAndPathSet
Position:0
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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 0 értéket ad meg, akkor a Windows PowerShell a számítógépen futó CIM-parancsmagok száma alapján kiszámítja a parancsmag optimális szabályozási korlátját. A szabályozási korlát csak az aktuális parancsmagra vonatkozik, a munkamenetre és a számítógépre nem.

Paramétertulajdonságok

Típus:Int32
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-UseExisting

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

Mielőtt megadja ezt a paramétert ehhez a parancsmaghoz, tekintse át A Windows PowerShell 5.0 újdonságaicímű cikkben található információkat.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

ComputerNameAndUseExistingSet
Position:Named
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
CimSessionAndUseExistingSet
Position:Named
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Wi

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.