Polecenie cmdlet Test-DscConfiguration sprawdza, czy rzeczywista konfiguracja węzłów jest zgodna z żądaną konfiguracją. Określ komputery, dla których chcesz przetestować konfiguracje przy użyciu nazw komputerów lub sesji modelu wspólnych informacji (CIM). Jeśli komputer docelowy nie zostanie określony, polecenie cmdlet testuje konfigurację komputera lokalnego.
Jeśli żądane i rzeczywiste konfiguracje są zgodne, polecenie cmdlet zwraca wartość ciągu "True".
W przeciwnym razie zwraca wartość ciągu "False".
Przykłady
Przykład 1. Testowanie konfiguracji komputera lokalnego
Test-DscConfiguration
To polecenie testuje konfigurację komputera lokalnego.
Przykład 2: Testowanie konfiguracji dla określonego komputera
W tym przykładzie przetestuj konfigurację z komputera określonego przez sesję modelu CIM. 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 New-CimSession.
Drugie polecenie testuje konfigurację komputerów zidentyfikowanych przez CimSession obiektów przechowywanych w zmiennej $Session, w tym przypadku komputera o nazwie Server01.
Przykład 3. Testowanie konfiguracji ze szczegółowymi wynikami
To polecenie testuje konfiguracje dla zestawu komputerów określonych przez parametr ComputerName i zwraca szczegółowe informacje, które zawierają ogólny stan, zasoby, które są w żądanym stanie, zasoby, które nie znajdują się w żądanym stanie i nazwa komputera.
Przykład 4. Konfiguracje testów określone w folderze
To polecenie testuje konfiguracje zdefiniowane w folderze określonym przez parametr ścieżka .
Konfiguracje są testowane pod kątem zestawu komputerów, z których każda jest identyfikowana przez nazwę pliku konfiguracji.
To polecenie sprawdza konfigurację zdefiniowaną w pliku względem zestawu komputerów określonych przez parametr ComputerName.
Parametry
-AsJob
Wskazuje, że to polecenie cmdlet uruchamia polecenie jako zadanie w tle.
Jeśli określisz parametr AsJob, polecenie zwróci obiekt reprezentujący zadanie, a następnie wyświetli wiersz polecenia. Możesz kontynuować pracę w sesji do momentu zakończenia zadania.
Zadanie jest tworzone na komputerze lokalnym, a wyniki z komputerów zdalnych są automatycznie zwracane do komputera lokalnego. Aby zarządzać zadaniem, użyj poleceń cmdlet zadania. Aby uzyskać wyniki zadania, użyj polecenia cmdlet Receive-Job.
Aby użyć tego parametru, komputery lokalne i zdalne muszą być skonfigurowane do komunikacji zdalnej, a w systemie Windows Vista i nowszych wersjach systemu operacyjnego Windows należy otworzyć program Windows PowerShell z opcją Uruchom jako administrator. Aby uzyskać więcej informacji, zobacz about_Remote_Requirements.
Aby uzyskać więcej informacji na temat zadań w tle programu Windows PowerShell, zobacz about_Jobs i about_Remote_Jobs.
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 tablicę nazw komputerów, na których to polecenie cmdlet testuje konfigurację. Polecenie cmdlet testuje dokument konfiguracji w lokalizacji określonej przez Path parametr na tych komputerach.
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.
Wskazuje, że to polecenie cmdlet zwraca szczegółowy wynik porównania dokumentu konfiguracji z żądanym stanem węzłów. Wynik zawiera informacje, takie jak ogólny stan, zasoby, które znajdują się w żądanym stanie, zasoby, które nie są w żądanym stanie i nazwa komputera.
Określa ścieżkę folderu zawierającego pliki dokumentów konfiguracji. Polecenie cmdlet sprawdza konfigurację pod kątem żądanego stanu komputerów określonych przez parametr ComputerName lub CimSession.
Określa ścieżkę pliku dokumentu konfiguracji. To polecenie cmdlet testuje konfigurację względem rzeczywistego stanu komputerów określonych przez ComputerName lub CimSession parametru.
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.
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 treści można znaleźć na GitHubie, gdzie można także tworzyć i przeglądać problemy oraz pull requesty. Więcej informacji znajdziesz w naszym przewodniku dla współautorów.
