Dela via

Test-ComputerSecureChannel

  • Referens
Modul:
Microsoft.PowerShell.Management

Testar och reparerar den säkra kanalen mellan den lokala datorn och dess domän.

Syntax

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

Description

Cmdleten Test-ComputerSecureChannel verifierar att kanalen mellan den lokala datorn och dess domän fungerar korrekt genom att kontrollera statusen för dess förtroenderelationer. Om en anslutning misslyckas kan du använda parametern Reparera för att försöka återställa den.

Test-ComputerSecureChannel returnerar $True om kanalen fungerar korrekt och $False om den inte är det. Med det här resultatet kan du använda cmdleten i villkorsstyrda instruktioner i funktioner och skript. Om du vill få mer detaljerade testresultat använder du parametern Utförlig.

Den här cmdleten fungerar ungefär som NetDom.exe. Både NetDom och Test-ComputerSecureChannel använda tjänsten NetLogon för att utföra åtgärderna.

Exempel

Exempel 1: Testa en kanal mellan den lokala datorn och dess domän

PS C:\> Test-ComputerSecureChannel
True

Det här kommandot testar kanalen mellan den lokala datorn och domänen som den är ansluten till.

Exempel 2: Testa en kanal mellan den lokala datorn och en domänkontrollant

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

Det här kommandot anger en önskad domänkontrollant för testet.

Exempel 3: Återställa kanalen mellan den lokala datorn och dess domän

PS C:\> Test-ComputerSecureChannel -Repair
True

Det här kommandot återställer kanalen mellan den lokala datorn och dess domän.

Exempel 4: Visa detaljerad information om testet

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."

Det här kommandot använder den utförliga gemensamma parametern för att begära detaljerade meddelanden om åtgärden. Mer information om utförligafinns i about_CommonParameters.

Exempel 5: Testa en anslutning innan du kör ett skript

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

Det här exemplet visar hur du använder Test-ComputerSecureChannel för att testa en anslutning innan du kör ett skript som kräver anslutningen.

Det första kommandot använder cmdleten Set-Alias för att skapa ett alias för cmdlet-namnet. Detta sparar utrymme och förhindrar att fel skrivs.

Instruktionen If kontrollerar värdet som Test-ComputerSecureChannel returnerar innan ett skript körs.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Anger ett användarkonto som har behörighet att utföra den här åtgärden. Ange ett användarnamn, till exempel User01 eller Domain01\User01, eller ange ett PSCredential- objekt, till exempel ett objekt som Get-Credential cmdleten returnerar. Som standard använder cmdleten den aktuella användarens autentiseringsuppgifter.

Parametern Credential är utformad för användning i kommandon som använder parametern Repair för att reparera kanalen mellan datorn och domänen.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Repair

Anger att den här cmdleten tar bort och sedan återskapar kanalen som upprättats av NetLogon-tjänsten. Använd den här parametern för att försöka återställa en anslutning som har misslyckats med testet.

Om du vill använda den här parametern måste den aktuella användaren vara medlem i gruppen Administratörer på den lokala datorn.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Server

Anger vilken domänkontrollant som ska köra kommandot. Om den här parametern inte anges väljer den här cmdleten en standarddomänkontrollant för åtgärden.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Du kan inte skicka indata till den här cmdleten.

Utdata

Boolean

Den här cmdleten returnerar $True om anslutningen fungerar korrekt och $False om den inte är det.

Kommentarer

  • Om du vill köra ett Test-ComputerSecureChannel--kommando i Windows Vista och senare versioner av Windows-operativsystemet öppnar du Windows PowerShell med alternativet Kör som administratör.
  • Test-ComputerSecureChannel implementeras med hjälp av funktionen I_NetLogonControl2, som styr olika aspekter av Netlogon-tjänsten.