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 Test-DscConfiguration cmdlet 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 nie określisz komputera docelowego, 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 sprawdza konfigurację komputera lokalnego.

Przykład 2. Testowanie konfiguracji dla określonego komputera

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

Ten przykładowy test konfiguracji z komputera określonego przez sesję CIM. W przykładzie jest tworzona sesja 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 przechowuje obiekt CimSession w zmiennej $Session . Polecenie wyświetla monit o hasło. Aby uzyskać więcej informacji, wpisz polecenie Get-Help New-CimSession.

Drugie polecenie testuje konfigurację komputerów zidentyfikowanych przez obiekty CimSession przechowywane w zmiennej $Session , w tym przypadku komputer 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 nazwie 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 Path . 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 Receive-Job polecenia cmdlet .

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ć Windows PowerShell z opcją Uruchom jako administrator. Aby uzyskać więcej informacji, zobacz about_Remote_Requirements.

Aby uzyskać więcej informacji na temat zadań Windows PowerShell w tle, zobacz about_Jobs i about_Remote_Jobs.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Określa tablicę nazw komputerów, na których to polecenie cmdlet sprawdza konfigurację. Polecenie cmdlet testuje dokument konfiguracji w lokalizacji określonej przez parametr Path do tych komputerów.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
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

-Detailed

Wskazuje, że to polecenie cmdlet zwraca szczegółowy wynik porównywania dokumentu konfiguracji z żądanym stanem węzłów. Wynik zawiera informacje, takie jak ogólny stan, zasoby, które są w żądanym stanie, zasoby, które nie są w żądanym stanie i nazwa komputera.

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

-Path

Określa ścieżkę folderu zawierającego pliki dokumentów konfiguracji. Polecenie cmdlet sprawdza konfigurację względem żądanego stanu komputerów określonych przez parametr ComputerName lub CimSession .

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

-ReferenceConfiguration

Określa ścieżkę pliku dokumentu konfiguracji. To polecenie cmdlet sprawdza konfigurację względem rzeczywistego stanu komputerów określonych przez parametr ComputerName lub CimSession .

Type:String
Position:Named
Default value:None
Required:True
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, które są uruchomione 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