Sdílet prostřednictvím

Publish-DscConfiguration

  • Reference
Modul:
PSDesiredStateConfiguration

Publikuje konfiguraci DSC do sady počítačů.

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

Rutina Publish-DscConfiguration publikuje dokument konfigurace Windows PowerShell Desired State Configuration (DSC) na sadě počítačů. Tato rutina nepoužije konfiguraci. Konfigurace se používají rutinou Start-DscConfiguration při použití s parametrem UseExisting nebo při spuštění cyklu konzistence modulu DSC. Modul DSC se označuje také jako místní Configuration Manager (LCM).

Tato rutina je zvlášť užitečná, když se doručují fragmenty více konfiguračních dokumentů. Když je doručeno více fragmentů dokumentů konfigurace, přepíší starší fragmenty konfiguračních dokumentů.

Příklady

Příklad 1: Publikování konfigurace do vzdáleného počítače

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

Tento příkaz publikuje konfiguraci do vzdáleného počítače. Uživatel, který spouští rutinu, by měl být na vzdáleném počítači správcem.

Parametry

-CimSession

Spustí rutinu ve vzdálené relaci nebo na vzdáleném počítači. Zadejte název počítače nebo objekt relace, například výstup rutiny New-CimSession nebo Get-CimSession . Výchozí hodnota je aktuální relace v místním počítači.

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

-ComputerName

Určuje jeden nebo více počítačů, na kterých tato rutina publikuje konfiguraci.

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Credential

Určuje přihlašovací údaje, které se používají pro přístup k cílovému zařízení.

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

-Force

Vynutí dokončení rutiny. Pokud je místní Configuration Manager režimu aktualizace nastavená na PULL, změní se použití tohoto parametru na PUSH a umožní publikování konfigurace DSC. Pokud také existuje čekající konfigurace DSC, použitím tohoto parametru se přepíše čekající konfigurace.

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

-Path

Určuje cestu, která obsahuje konfigurace pro publikování do cílových počítačů.

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

-ThrottleLimit

Určuje maximální počet souběžných operací, které je možné vytvořit pro spuštění rutiny. Pokud je tento parametr vynechán nebo je zadána hodnota 0 , vypočítá Windows PowerShell optimální limit omezení pro rutinu na základě počtu rutin CIM spuštěných v počítači. Omezení se vztahuje pouze na aktuální rutinu, nikoli na relaci nebo na počítač.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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