Sdílet prostřednictvím

Test-ComputerSecureChannel

  • Reference
Modul:
Microsoft.PowerShell.Management

Testuje a opravuje zabezpečený kanál mezi místním počítačem a jeho doménou.

Syntaxe

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

Description

Rutina Test-ComputerSecureChannel ověří, že kanál mezi místním počítačem a jeho doménou funguje správně, a to kontrolou stavu vztahů důvěryhodnosti. Pokud připojení selže, můžete ho obnovit pomocí parametru Opravit.

Test-ComputerSecureChannel vrátí $True, pokud kanál funguje správně a $False, pokud není. Tento výsledek umožňuje použít rutinu v podmíněných příkazech ve funkcích a skriptech. Pokud chcete získat podrobnější výsledky testu, použijte parametr Podrobné.

Tato rutina funguje podobně jako NetDom.exe. NetDom i Test-ComputerSecureChannel k provedení akcí použijte službu NetLogon.

Příklady

Příklad 1: Testování kanálu mezi místním počítačem a jeho doménou

PS C:\> Test-ComputerSecureChannel
True

Tento příkaz otestuje kanál mezi místním počítačem a doménou, ke které je připojený.

Příklad 2: Testování kanálu mezi místním počítačem a řadičem domény

PS C:\> Test-ComputerSecureChannel -Server "DCName.fabrikam.com"
True

Tento příkaz určuje upřednostňovaný řadič domény pro test.

Příklad 3: Resetování kanálu mezi místním počítačem a jeho doménou

PS C:\> Test-ComputerSecureChannel -Repair
True

Tento příkaz resetuje kanál mezi místním počítačem a jeho doménou.

Příklad 4: Zobrazení podrobných informací o testu

PS C:\> 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."

Tento příkaz používá Podrobný společný parametr k vyžádání podrobných zpráv o operaci. Další informace o podrobnénaleznete v tématu about_CommonParameters.

Příklad 5: Testování připojení před spuštěním skriptu

PS C:\> Set-Alias tcsc Test-ComputerSecureChannel
if (!(tcsc))
{Write-Host "Connection failed. Reconnect and retry."}
else { &(.\Get-Servers.ps1) }

Tento příklad ukazuje, jak použít Test-ComputerSecureChannel k otestování připojení před spuštěním skriptu, který vyžaduje připojení.

První příkaz použije rutinu Set-Alias k vytvoření aliasu pro název rutiny. Tím ušetříte místo a zabráníte tak překlepům.

Příkaz If zkontroluje hodnotu, která Test-ComputerSecureChannel vrátí před spuštěním skriptu.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Credential

Určuje uživatelský účet, který má oprávnění k provedení této akce. Zadejte uživatelské jméno, například User01 nebo Domain01\User01, nebo zadejte objekt PSCredential, například objekt, který Get-Credential rutina vrátí. Rutina ve výchozím nastavení používá přihlašovací údaje aktuálního uživatele.

Parametr přihlašovacích údajů je určený pro použití v příkazech, které k opravě kanálu mezi počítačem a doménou používají parametr Repair.

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Repair

Označuje, že tato rutina odebere a pak znovu sestaví kanál vytvořený službou NetLogon. Tento parametr použijte k pokusu o obnovení připojení, které test selhalo.

Chcete-li použít tento parametr, musí být aktuální uživatel členem skupiny Administrators v místním počítači.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Server

Určuje řadič domény, který má příkaz spustit. Pokud tento parametr není zadaný, tato rutina pro operaci vybere výchozí řadič domény.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Vstup do této rutiny nelze převést.

Výstupy

Boolean

Tato rutina vrátí $True, pokud připojení funguje správně, a pokud ne, $False.

Poznámky

  • Pokud chcete spustit příkaz Test-ComputerSecureChannel v systému Windows Vista a novějších verzích operačního systému Windows, otevřete Prostředí Windows PowerShell pomocí možnosti Spustit jako správce.
  • Test-ComputerSecureChannel se implementuje pomocí funkce I_NetLogonControl2, která řídí různé aspekty služby Netlogon.