Test-ComputerSecureChannel

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

L’applet de commande Test-ComputerSecureChannel vérifie que le canal entre l’ordinateur local et son domaine fonctionne correctement en vérifiant l’état de ses relations d’approbation. Si une connexion échoue, vous pouvez utiliser le paramètre Réparer pour essayer de le restaurer.

Test-ComputerSecureChannel retourne $True si le canal fonctionne correctement et $False si ce n’est pas le cas. Ce résultat vous permet d’utiliser l’applet de commande dans les instructions conditionnelles dans les fonctions et les scripts. Pour obtenir des résultats de test plus détaillés, utilisez le paramètre Verbose.

Cette applet de commande fonctionne beaucoup comme NetDom.exe. NetDom et Test-ComputerSecureChannel utiliser le service NetLogon pour effectuer les actions.

PS C:\> Test-ComputerSecureChannel
True

Cette commande teste le canal entre l’ordinateur local et le domaine auquel il est joint.

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

Cette commande spécifie un contrôleur de domaine préféré pour le test.

PS C:\> Test-ComputerSecureChannel -Repair
True

Cette commande réinitialise le canal entre l’ordinateur local et son domaine.

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

Cette commande utilise le paramètre Verbose commun pour demander des messages détaillés sur l’opération. Pour plus d’informations sur détaillé, consultez about_CommonParameters.

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

Cet exemple montre comment utiliser Test-ComputerSecureChannel pour tester une connexion avant d’exécuter un script nécessitant la connexion.

La première commande utilise l’applet de commande Set-Alias pour créer un alias pour le nom de l’applet de commande. Cela permet d’économiser de l’espace et d’éviter les erreurs de saisie.

L’instruction If vérifie la valeur qui Test-ComputerSecureChannel retourne avant d’exécuter un script.

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Vous ne pouvez pas diriger d'entrée vers cette applet de commande.

Cette applet de commande retourne $True si la connexion fonctionne correctement et $False si ce n’est pas le cas.

• Pour exécuter une commande Test-ComputerSecureChannel sur Windows Vista et versions ultérieures du système d’exploitation Windows, ouvrez Windows PowerShell à l’aide de l’option Exécuter en tant qu’administrateur.
• Test-ComputerSecureChannel est implémenté à l’aide de la fonction I_NetLogonControl2, qui contrôle différents aspects du service Netlogon.