Udostępnij za pośrednictwem

Publish-DscConfiguration

  • Odwołanie
Moduł:
PSDesiredStateConfiguration

Publikuje konfigurację DSC dla zestawu komputerów.

Składnia

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

Opis

Polecenie cmdlet Publish-DscConfiguration publikuje dokument konfiguracji Konfiguracji żądanego stanu programu Windows PowerShell (DSC) na zestawie komputerów. To polecenie cmdlet nie stosuje konfiguracji. Konfiguracje są stosowane przez polecenie cmdlet Start-DscConfiguration, gdy jest używane z parametrem UseExisting lub gdy aparat DSC uruchamia swój cykl spójności. Aparat DSC jest również znany jako Lokalny program Configuration Manager (LCM).

To polecenie cmdlet jest szczególnie przydatne, gdy dostarczane są fragmenty wielu dokumentów konfiguracji. Po dostarczeniu wielu fragmentów dokumentów konfiguracji zastępują starsze fragmenty dokumentu konfiguracji.

Przykłady

Przykład 1. Publikowanie konfiguracji na komputerze zdalnym

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

To polecenie publikuje konfigurację na komputerze zdalnym. Użytkownik, który uruchamia polecenie cmdlet, powinien być administratorem na komputerze zdalnym.

Parametry

-CimSession

Uruchamia polecenie cmdlet w sesji zdalnej lub na komputerze zdalnym. Wprowadź nazwę komputera lub obiekt sesji, taki jak dane wyjściowe polecenia cmdlet New-CimSession lub Get-CimSession. Wartość domyślna to bieżąca sesja na komputerze lokalnym.

Typ:CimSession[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ComputerName

Określa co najmniej jeden komputer, na którym to polecenie cmdlet publikuje konfigurację.

Typ:String[]
Aliasy:CN, ServerName
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Credential

Określa poświadczenia używane do uzyskiwania dostępu do urządzenia docelowego.

Typ:PSCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Wymusza zakończenie polecenia cmdlet. Jeśli tryb odświeżania lokalnego programu Configuration Manager jest ustawiony na PULL, użycie tego parametru zmieni go na PUSH i umożliwia publikację konfiguracji DSC. Ponadto jeśli istnieje oczekująca konfiguracja DSC, użycie tego parametru zastępuje oczekującą konfigurację.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Path

Określa ścieżkę zawierającą konfiguracje do publikowania na komputerach docelowych.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ThrottleLimit

Określa maksymalną liczbę współbieżnych operacji, które można ustanowić w celu uruchomienia polecenia cmdlet. Jeśli ten parametr zostanie pominięty lub zostanie wprowadzona wartość 0, program Windows PowerShell oblicza optymalny limit ograniczania dla polecenia cmdlet na podstawie liczby poleceń cmdlet ciM uruchomionych na komputerze. Limit ograniczania dotyczy tylko bieżącego polecenia cmdlet, a nie sesji lub komputera.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False