Start-DscConfiguration

  • Odwołanie
Moduł:
PSDesiredStateConfiguration

Stosuje konfigurację do węzłów.

Składnia

Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Opis

Polecenie Start-DscConfiguration cmdlet stosuje konfigurację do węzłów. W przypadku użycia z parametrem UseExisting jest stosowana istniejąca konfiguracja na komputerze docelowym. Określ komputery, do których chcesz zastosować konfigurację, określając nazwy komputerów lub używając sesji modelu wspólnych informacji (CIM).

Domyślnie to polecenie cmdlet tworzy zadanie i zwraca obiekt Zadania . Aby uzyskać więcej informacji na temat zadań w tle, wpisz Get-Help about_Jobs. Aby użyć tego polecenia cmdlet interaktywnie, określ parametr Wait .

Określ parametr Verbose , aby wyświetlić szczegółowe informacje o tym, co robi polecenie cmdlet w przypadku zastosowania ustawień konfiguracji.

Przykłady

Przykład 1. Stosowanie ustawień konfiguracji

Start-DscConfiguration -Path "C:\DSC\Configurations\"

To polecenie stosuje ustawienia konfiguracji z C:\DSC\Configurations\ programu do każdego komputera z ustawieniami w tym folderze. Polecenie zwraca obiekty zadania dla każdego węzła docelowego wdrożonego w.

Przykład 2: Stosowanie ustawień konfiguracji i oczekiwanie na ukończenie konfiguracji

Start-DscConfiguration -Path "C:\DSC\Configurations\" -Wait -Verbose

To polecenie stosuje konfigurację z C:\DSC\Configurations\ komputera lokalnego. Polecenie zwraca obiekty zadania dla każdego węzła docelowego wdrożonego w tym przypadku tylko na komputerze lokalnym. W tym przykładzie określono parametr Verbose . W związku z tym polecenie wysyła komunikaty do konsoli w miarę postępu. Polecenie zawiera parametr Wait . W związku z tym nie można użyć konsoli, dopóki polecenie nie zakończy wszystkich zadań konfiguracji.

Przykład 3. Stosowanie ustawień konfiguracji przy użyciu sesji ciągłej integracji

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Start-DscConfiguration -Path "C:\DSC\Configurations\" -CimSession $Session

W tym przykładzie są stosowane ustawienia konfiguracji do określonego komputera. W przykładzie jest tworzona sesja modelu ciągłej integracji dla komputera o nazwie Server01 do użycia z poleceniem cmdlet . Alternatywnie utwórz tablicę sesji ciM, aby zastosować polecenie cmdlet do wielu określonych komputerów.

Pierwsze polecenie tworzy sesję CIM przy użyciu New-CimSession polecenia cmdlet , a następnie zapisuje obiekt CimSession w zmiennej $Session . Polecenie wyświetla monit o podanie hasła. Aby uzyskać więcej informacji, wpisz polecenie Get-Help NewCimSession.

Drugie polecenie stosuje ustawienia konfiguracji z C:\DSC\Configurations programu do komputerów zidentyfikowanych przez obiekty CimSession przechowywane w zmiennej $Session . W tym przykładzie zmienna $Session zawiera sesję modelu ciągłej integracji tylko dla komputera o nazwie Server01. Polecenie stosuje konfigurację. Polecenie tworzy obiekty zadania dla każdego skonfigurowanego komputera.

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 tablicę nazw komputerów. Ten parametr ogranicza komputery, które mają dokumenty konfiguracji w parametrze Ścieżka do tych określonych w tablicy.

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 nazwę użytkownika i hasło jako obiekt PSCredential dla komputera docelowego. Aby uzyskać obiekt PSCredential , użyj Get-Credential polecenia cmdlet . Aby uzyskać więcej informacji, wpisz polecenie Get-Help Get-Credential.

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

-Force

Zatrzymuje operację konfiguracji aktualnie uruchomioną na komputerze docelowym i rozpoczyna nową operację Start-Configuration. Jeśli właściwość RefreshMode Configuration Manager lokalnej jest ustawiona na pull, określając ten parametr zmieni go na Push.

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

-JobName

Określa przyjazną nazwę zadania. Jeśli określisz ten parametr, polecenie cmdlet zostanie uruchomione jako zadanie i zwróci obiekt Zadania .

Domyślnie Windows PowerShell przypisuje nazwę JobN, gdzie N jest liczbą całkowitą.

Jeśli określisz parametr Wait , nie określ tego parametru.

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

-Path

Określa ścieżkę pliku folderu zawierającego pliki ustawień konfiguracji. To polecenie cmdlet publikuje i stosuje te ustawienia konfiguracji do komputerów z plikami ustawień w określonej ścieżce. Każdy węzeł docelowy musi mieć plik ustawień w następującym formacie: <NetBIOS Name>.mof.

Type:String
Position:0
Default value:None
Required:False
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

-UseExisting

Wskazuje, że to polecenie cmdlet stosuje istniejącą konfigurację. Konfiguracja może istnieć na komputerze docelowym przez uchwalenie przy użyciu Start-DscConfiguration lub publikacji przy użyciu polecenia cmdlet Publish-DscConfiguration.

Przed określeniem tego parametru dla tego polecenia cmdlet zapoznaj się z informacjami w artykule Co nowego w programie Windows PowerShell 5.0.

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

-Wait

Wskazuje, że polecenie cmdlet blokuje konsolę do momentu zakończenia wszystkich zadań konfiguracji.

Jeśli określisz ten parametr, nie określ parametru JobName .

Type:SwitchParameter
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