Share via

Publish-DscConfiguration

  • Referencia
Modul:
PSDesiredStateConfiguration

DSC-konfigurációt tesz közzé egy számítógépcsoportban.

Syntax

Publish-DscConfiguration
       [-Path] <String>
       [-Force]
       [[-ComputerName] <String[]>]
       [-Credential <PSCredential>]
       [-ThrottleLimit <Int32>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-DscConfiguration
       [-Path] <String>
       [-Force]
       [-ThrottleLimit <Int32>]
       -CimSession <CimSession[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

A Publish-DscConfiguration parancsmag Windows PowerShell Desired State Configuration (DSC) konfigurációs dokumentumot tesz közzé a számítógépek készletén. Ez a parancsmag nem alkalmazza a konfigurációt. A konfigurációkat a Start-DscConfiguration parancsmag alkalmazza, amikor a UseExisting paraméterrel használja, vagy amikor a DSC-motor futtatja a konzisztenciaciklusát. A DSC motort helyi Configuration Manager (LCM) néven is ismert.

Ez a parancsmag különösen hasznos több konfigurációs dokumentum kézbesítésekor. Több konfigurációs dokumentumtöredék kézbesítésekor felülírják a régebbi konfigurációs dokumentumtöredékeket.

Példák

1. példa: Konfiguráció közzététele távoli számítógépen

Publish-DscConfiguration -Path '$home\WebServer' -ComputerName "ContosoWebServer" -Credential (get-credential Contoso\webadministrator)

Ez a parancs egy konfigurációt tesz közzé egy távoli számítógépen. A parancsmagot futtató felhasználónak rendszergazdaként kell lennie a távoli számítógépen.

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

Egy vagy több számítógépet ad meg, amelyen a parancsmag közzéteszi a konfigurációt.

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éleszköz eléréséhez használt hitelesítő adatokat.

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

-Force

Kényszeríti a parancsmag befejezését. Ha a Helyi Configuration Manager frissítési mód PULL értékre van állítva, a paraméter használata PUSH értékre módosítja, és lehetővé teszi a DSC-konfiguráció közzétételét. Ha függőben lévő DSC-konfiguráció is létezik, a paraméter használata felülírja a függőben lévő konfigurációt.

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

-Path

A célszámítógépeken közzéteendő konfigurációkat tartalmazó elérési utat adja meg.

Type:String
Position:0
Default value:None
Required:True
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

-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