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.
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
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
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.
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.
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.
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.
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.
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.
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Źródło tej zawartości można znaleźć w witrynie GitHub, gdzie można również tworzyć i przeglądać problemy oraz żądania ściągnięcia. Aby uzyskać więcej informacji, zapoznaj się z naszym przewodnikiem dla twórców.
