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 Publish-DscConfiguration cmdlet publikuje dokument konfiguracji Windows PowerShell Desired State Configuration (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 cykl spójności. Aparat DSC jest również nazywany lokalnym Configuration Manager (LCM).

To polecenie cmdlet jest szczególnie przydatne, gdy dostarczane są fragmenty wielu dokumentów konfiguracyjnych. Po dostarczeniu wielu fragmentów dokumentów konfiguracji zastępują one 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.

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

-ComputerName

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

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-Credential

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

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

-Force

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

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

-Path

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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, 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.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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