Publish-DscConfiguration
Veröffentlicht eine DSC-Konfiguration in 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 Cmdlet Publish-DscConfiguration veröffentlicht ein DSC-Konfigurationsdokument (Windows PowerShell Desired State Configuration) auf einer Gruppe von Computern. Dieses Cmdlet wendet die Konfiguration nicht an.
Konfigurationen werden entweder vom Cmdlet Start-DscConfiguration angewendet, wenn es mit dem parameter UseExisting verwendet wird oder wenn das DSC-Modul seinen Konsistenzzyklus ausführt. Das DSC-Modul wird auch als Local Configuration Manager (LCM) bezeichnet.
Dieses Cmdlet ist besonders hilfreich, 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 Cmdlet. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.
| Typ: | CimSession[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ComputerName
Gibt einen oder mehrere Computer an, auf denen dieses Cmdlet die Konfiguration veröffentlicht.
| Typ: | String[] |
| Aliase: | CN, ServerName |
| Position: | 1 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Credential
Gibt Anmeldeinformationen an, die für den Zugriff auf das Zielgerät verwendet werden.
| Typ: | PSCredential |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Force
Erzwingt den Abschluss des Cmdlets. Wenn der Aktualisierungsmodus für den lokalen Configuration Manager auf PULL festgelegt ist, ändert die Verwendung dieses Parameters 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 diese ausstehende Konfiguration.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Path
Gibt einen Pfad an, der Konfigurationen enthält, die auf Zielcomputern veröffentlicht werden sollen.
| Typ: | String |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ThrottleLimit
Gibt die maximale Anzahl gleichzeitiger Vorgänge an, die zum Ausführen des Cmdlets eingerichtet werden können. Wenn dieser Parameter ausgelassen wird 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. Der Drosselungsgrenzwert gilt nur für das aktuelle Cmdlet, nicht für die Sitzung oder für den Computer.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
