Share via

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 Test-ComputerSecureChannel cmdlet 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 Napraw , aby spróbować go przywrócić.

Test-ComputerSecureChannel Metoda zwraca $True, jeśli kanał działa prawidłowo i $False, jeśli nie. 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żyj usługi NetLogon do wykonania 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 pełnego wspólnego parametru, aby zażądać szczegółowych komunikatów dotyczących operacji. Aby uzyskać więcej informacji o pełnej lekcji, 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 przetestować Test-ComputerSecureChannel połączenie przed uruchomieniem skryptu wymagającego połączenia.

Instrukcja if sprawdza wartość zwracaną Test-ComputerSecureChannel przed uruchomieniem skryptu.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 , na przykład taki, który zwraca 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ą.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Administracja istratorów na komputerze lokalnym.

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

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 informację, czy połączenie działa poprawnie i $False jeśli 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 implementowany przy użyciu funkcji I_NetLogonControl2 , która kontroluje różne aspekty usługi Netlogon.