Freigeben über

Publish-DscConfiguration

  • Referenz
Modul:
PSDesiredStateConfiguration

Veröffentlicht eine DSC-Konfiguration auf einer Gruppe von Computern.

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>]

Beschreibung

Das Publish-DscConfiguration Cmdlet veröffentlicht ein Windows PowerShell Desired State Configuration -Konfigurationsdokument (DSC) auf einem Computersatz. Dieses Cmdlet wendet die Konfiguration nicht an. Konfigurationen werden entweder vom Cmdlet Start-DscConfiguration angewendet, wenn es mit dem UseExisting-Parameter verwendet wird oder wenn die DSC-Engine ihren Konsistenzzyklus ausführt. Die DSC-Engine wird auch als Local Configuration Manager (LCM) bezeichnet.

Dieses Cmdlet ist besonders nützlich, wenn Fragmente mehrerer Konfigurationsdokumente übermittelt werden. Wenn mehrere Konfigurationsdokumentfragmente übermittelt werden, überschreiben sie die älteren Konfigurationsdokumentfragmente.

Beispiele

Beispiel 1: Veröffentlichen einer Konfiguration auf einem Remotecomputer

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

Dieser Befehl veröffentlicht eine Konfiguration auf einem Remotecomputer. Der Benutzer, der das Cmdlet ausführt, sollte Administrator auf dem Remotecomputer sein.

Parameter

-CimSession

Führt das Cmdlet in einer Remotesitzung oder auf einem Remotecomputer aus. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, z. B. die Ausgabe eines New-CimSession- oder Get-CimSession-Cmdlets . Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.

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

-ComputerName

Gibt mindestens einen Computer an, auf dem dieses Cmdlet die Konfiguration veröffentlicht.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-Credential

Gibt Anmeldeinformationen an, die für den Zugriff auf das Zielgerät verwendet werden.

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

-Force

Erzwingt den Abschluss des Cmdlets. Wenn der Aktualisierungsmodus "Local Configuration Manager" auf PULL festgelegt ist, ändert sich dieser Parameter in PUSH und ermöglicht die Veröffentlichung der DSC-Konfiguration. Wenn eine ausstehende DSC-Konfiguration vorhanden ist, überschreibt die Verwendung dieses Parameters außerdem die ausstehende Konfiguration.

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

-Path

Gibt einen Pfad an, der Konfigurationen für die Veröffentlichung auf Zielcomputern enthält.

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

-ThrottleLimit

Gibt die maximale Anzahl von gleichzeitigen Vorgängen an, die zum Ausführen des Cmdlets erstellt werden können. Wenn dieser Parameter ausgelassen oder ein Wert von 0 eingegeben wird, berechnet Windows PowerShell ein optimales Drosselungslimit für das Cmdlet basierend auf der Anzahl der CIM-Cmdlets, die auf dem Computer ausgeführt werden. Dieser Drosselungsgrenzwert gilt nur für das aktuelle Cmdlet, nicht für die Sitzung oder den PC.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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