Test-ComputerSecureChannel

Odwołanie

Moduł:: Microsoft.PowerShell.Management

Testuje i naprawia bezpieczny kanał między komputerem lokalnym a jego domeną.

Składnia

Test-ComputerSecureChannel
    [-Repair]
    [-Server <String>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Polecenie cmdlet Test-ComputerSecureChannel sprawdza, czy kanał między komputerem lokalnym a jego domeną działa prawidłowo, sprawdzając stan relacji zaufania. Jeśli połączenie nie powiedzie się, możesz użyć parametru Repair, aby spróbować go przywrócić.

Test-ComputerSecureChannel zwraca $True, jeśli kanał działa prawidłowo i $False, jeśli tak nie jest. Ten wynik umożliwia użycie polecenia cmdlet w instrukcjach warunkowych w funkcjach i skryptach. Aby uzyskać bardziej szczegółowe wyniki testu, użyj parametru Verbose.

To polecenie cmdlet działa podobnie jak NetDom.exe. Zarówno netDom, jak i Test-ComputerSecureChannel używać usługi NetLogon do wykonywania akcji.

Przykłady

Przykład 1: Testowanie kanału między komputerem lokalnym a jego domeną

Test-ComputerSecureChannel

To polecenie sprawdza kanał między komputerem lokalnym a domeną, do której jest przyłączony.

Przykład 2: Testowanie kanału między komputerem lokalnym a kontrolerem domeny

Test-ComputerSecureChannel -Server "DCName.fabrikam.com"
True

To polecenie określa preferowany kontroler domeny dla testu.

Przykład 3. Resetowanie kanału między komputerem lokalnym a jego domeną

Test-ComputerSecureChannel -Repair

To polecenie resetuje kanał między komputerem lokalnym a jego domeną.

Przykład 4. Wyświetlanie szczegółowych informacji o teście

Test-ComputerSecureChannel -Verbose

VERBOSE: Performing operation "Test-ComputerSecureChannel" on Target "SERVER01".
True
VERBOSE: "The secure channel between 'SERVER01' and 'net.fabrikam.com' is alive and working correctly."

To polecenie używa Verbose wspólnego parametru, aby zażądać szczegółowych komunikatów dotyczących operacji. Aby uzyskać więcej informacji na temat Pełne, zobacz about_CommonParameters.

Przykład 5. Testowanie połączenia przed uruchomieniem skryptu

if (!(Test-ComputerSecureChannel)) {
    Write-Host "Connection failed. Reconnect and retry."
}
else {
    &(.\Get-Servers.ps1)
}

W tym przykładzie pokazano, jak używać Test-ComputerSecureChannel do testowania połączenia przed uruchomieniem skryptu wymagającego połączenia.

Instrukcja if sprawdza wartość, która Test-ComputerSecureChannel zwraca przed uruchomieniem skryptu.

Parametry

-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 konto użytkownika, które ma uprawnienia do wykonania tej akcji. Wpisz nazwę użytkownika, taką jak User01 lub Domain01\User01, lub wprowadź obiekt PSCredential, taki jak obiekt zwracany przez polecenie cmdlet Get-Credential. Domyślnie polecenie cmdlet używa poświadczeń bieżącego użytkownika.

Parametr Credential jest przeznaczony do użycia w poleceniach, które używają parametru Repair do naprawy kanału między komputerem a domeną.

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

-Repair

Wskazuje, że to polecenie cmdlet usuwa, a następnie ponownie kompiluje kanał ustanowiony przez usługę NetLogon. Użyj tego parametru, aby spróbować przywrócić połączenie, które zakończyło się niepowodzeniem testu.

Aby użyć tego parametru, bieżący użytkownik musi być członkiem grupy Administratorzy na komputerze lokalnym.

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

-Server

Określa kontroler domeny do uruchomienia polecenia. Jeśli ten parametr nie zostanie określony, to polecenie cmdlet wybierze domyślny kontroler domeny dla operacji.

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

Dane wejściowe

None

Nie można przekazać danych wejściowych potoku do tego polecenia cmdlet.

Dane wyjściowe

Boolean

To polecenie cmdlet zwraca $True, jeśli połączenie działa poprawnie i $False, jeśli tak nie jest.

Uwagi

Aby uruchomić Test-ComputerSecureChannel polecenie w systemie Windows Vista i nowszych wersjach systemu operacyjnego Windows, otwórz program Windows PowerShell przy użyciu opcji Uruchom jako administrator.
Test-ComputerSecureChannel jest implementowana przy użyciu funkcji I_NetLogonControl2, która kontroluje różne aspekty usługi Netlogon.