Udostępnij za pośrednictwem

Test-DscConfiguration

  • Odwołanie
Moduł:
PSDesiredStateConfiguration

Sprawdza, czy rzeczywista konfiguracja węzłów jest zgodna z żądaną konfiguracją.

Składnia

Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]
Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Path] <String>
    [<CommonParameters>]
Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    -ReferenceConfiguration <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    [-Path] <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    -ReferenceConfiguration <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]

Opis

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

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Test-DscConfiguration -CimSession $Session

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

Test-DscConfiguration -ComputerName "Server01", "Server02", "Server03" -Detailed

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

Test-DscConfiguration -Path "C:\Dsc\Configurations"

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.

Przykład 5. Konfiguracje testów określone w pliku

Test-DscConfiguration -ReferenceConfiguration "C:\Dsc\Configurations\WebServer.mof" -ComputerName "Server01", "Server02", "Server03"

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.

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

-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, na których to polecenie cmdlet testuje konfigurację. Polecenie cmdlet testuje dokument konfiguracji w lokalizacji określonej przez Path parametr na tych komputerach.

Typ:String[]
Aliasy:CN, ServerName
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
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

-Detailed

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.

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

-Path

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.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ReferenceConfiguration

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.

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