Udostępnij przez

Test-ComputerSecureChannel

Moduł:
Microsoft.PowerShell.Management Module

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

Składnia

Default (domyślnie) 

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 Metoda zwraca $true, jeśli kanał działa poprawnie 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.

Uwaga / Notatka

To polecenie cmdlet działa tylko na komputerach członkowskich domeny. Po uruchomieniu go na kontrolerach domeny zwracane są błędy fałszywie dodatnie. Aby zweryfikować i zresetować bezpieczne kanały dla kontrolerów domeny, użyj polecenia netdom.exe lub nltest.exe.

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

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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ą.

Właściwości parametru

Typ:PSCredential
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie został uruchomiony.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

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.

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.