Update-DscConfiguration

  • Referencia
Modul:
PSDesiredStateConfiguration

Ellenőrzi a lekérési kiszolgáló frissített konfigurációját, és alkalmazza azt.

Syntax

Update-DscConfiguration
      [-Wait]
      [-JobName <String>]
      [[-ComputerName] <String[]>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-DscConfiguration
      [-Wait]
      [-JobName <String>]
      [-ThrottleLimit <Int32>]
      -CimSession <CimSession[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

A Update-DscConfiguration parancsmag csatlakozik egy lekéréses kiszolgálóhoz, letölti a konfigurációt, ha eltér a csomópont aktuális állapotától, majd alkalmazza a konfigurációt a számítógépre.

Ez a parancsmag csak a 2014. novemberi kumulatív frissítés részeként érhető el a Windows RT 8.1-re, Windows 8.1-re és Windows Server 2012 R2-re.

Példák

1. példa: Konfiguráció frissítése

Update-DscConfiguration -Wait -Verbose

A parancs futtatása után a kiszolgáló csatlakozik a regisztrált lekéréses szolgáltatáshoz, letölti a legújabb hozzárendelt konfigurációt, majd alkalmazza azt. A Wait és a Verbose paraméterek megadása nem kötelező. Az interaktív munka során ezek a paraméterek együttesen valós idejű visszajelzést tesznek lehetővé a konfiguráció alkalmazásakor az előrehaladásról, a sikerességről vagy a sikertelenségről.

2. példa: Konfiguráció frissítése CIM-munkameneten keresztüli csatlakozással

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Update-DscConfiguration -CimSession $Session -Wait

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 New-CimSession.

A második parancs frissíti a cimSession fájlban megadott számítógépet.$Session A parancs a Wait paramétert adja meg. A konzol nem fogad el további parancsokat, amíg az aktuális parancs be nem fejeződik.

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 egy 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.

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. A parancsmag a konfigurációs beállításokat alkalmazza azokra a számítógépekre, amelyeket ez a paraméter határoz meg.

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

-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 Várakozás 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

-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

-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