Sdílet prostřednictvím

Publish-DscConfiguration

  • Reference
Modul:
PSDesiredStateConfiguration

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

Syntaxe

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 na sadě počítačů konfigurační dokument konfigurace DSC (Windows PowerShell Desired State Configuration). Tato rutina nepoužije konfiguraci. Konfigurace se použijí buď rutinou Start-DscConfiguration při použití s parametrem UseExisting, nebo když modul DSC spustí svůj cyklus konzistence. Modul DSC se také označuje jako LCM (Local Configuration Manager).

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

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ý rutinu spouští, by měl být správcem na vzdáleném počítači.

Parametry

-CimSession

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

Typ:CimSession[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ComputerName

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

Typ:String[]
Aliasy:CN, ServerName
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Credential

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

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Vynutí dokončení rutiny. Pokud je režim aktualizace local Configuration Manageru nastavený na PULL, použití tohoto parametru ho změní na PUSH a povolí publikování konfigurace DSC. Pokud existuje čekající konfigurace DSC, přepíše použití tohoto parametru tuto čekající konfiguraci.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Path

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

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ThrottleLimit

Určuje maximální počet souběžných operací, které lze navázat pro spuštění rutiny. Pokud tento parametr vynecháte nebo zadáte hodnotu 0, windows PowerShell vypočítá 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, ne na relaci nebo na počítač.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False