Udostępnij za pośrednictwem

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 cmdlet Start-DscConfiguration 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 przy użyciu sesji modelu wspólnych informacji (CIM).

Domyślnie to polecenie cmdlet tworzy zadanie i zwraca obiekt Job. 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\ do każdego komputera z ustawieniami w tym folderze. Polecenie zwraca obiekty zadania dla każdego węzła docelowego wdrożonego.

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\ do komputera lokalnego. Polecenie zwraca obiekty Job 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 podczas jego kontynuowania. Polecenie zawiera parametr Wait. W związku z tym nie można użyć konsoli, dopóki polecenie nie zakończy wszystkich zadań konfiguracyjnych.

Przykład 3. Stosowanie ustawień konfiguracji przy użyciu sesji modelu ciM

$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 ciM 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ę modelu CIM przy użyciu polecenia cmdlet New-CimSession, a następnie przechowuje obiekt CimSession w zmiennej $Session. Polecenie wyświetla monit o podanie hasła. Aby uzyskać więcej informacji, wpisz Get-Help NewCimSession.

Drugie polecenie stosuje ustawienia konfiguracji z C:\DSC\Configurations do komputerów zidentyfikowanych przez CimSession obiektów przechowywanych 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 Job 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.

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

-ComputerName

Określa tablicę nazw komputerów. Ten parametr ogranicza komputery, które mają dokumenty konfiguracji w Path parametr do tych określonych w tablicy.

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

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

-Force

Zatrzymuje operację konfiguracji aktualnie uruchomioną na komputerze docelowym i rozpoczyna nową operację Start-Configuration. Jeśli właściwość RefreshMode programu Local Configuration Manager jest ustawiona na wartość Pull, określenie tego parametru spowoduje zmianę go w Wypychanie.

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

-JobName

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

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

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:False
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

-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 Co nowego w programie Windows PowerShell 5.0.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

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