Partager via

Test-ComputerSecureChannel

  • Référence
Module:
Microsoft.PowerShell.Management

Teste et répare le canal sécurisé entre l’ordinateur local et son domaine.

Syntaxe

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

Description

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.

Exemples

Exemple 1 : Tester un canal entre l’ordinateur local et son domaine

Test-ComputerSecureChannel

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

Exemple 2 : Tester un canal entre l’ordinateur local et un contrôleur de domaine

Test-ComputerSecureChannel -Server "DCName.fabrikam.com"
True

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

Exemple 3 : Réinitialiser le canal entre l’ordinateur local et son domaine

Test-ComputerSecureChannel -Repair

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

Exemple 4 : Afficher des informations détaillées sur le test

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.

Exemple 5 : Tester une connexion avant d’exécuter un script

if (!(Test-ComputerSecureChannel)) {
    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.

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

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Credential

Spécifie un compte d’utilisateur autorisé à effectuer cette action. Tapez un nom d’utilisateur, tel que User01 ou Domain01\User01, ou entrez un objet PSCredential, tel que celui retourné par l’applet de commande Get-Credential. Par défaut, l’applet de commande utilise les informations d’identification de l’utilisateur actuel.

Le paramètre Credential est conçu pour être utilisé dans les commandes qui utilisent le paramètre Repair pour réparer le canal entre l’ordinateur et le domaine.

Type:PSCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Repair

Indique que cette applet de commande supprime, puis reconstruit le canal établi par le service NetLogon. Utilisez ce paramètre pour essayer de restaurer une connexion ayant échoué le test.

Pour utiliser ce paramètre, l’utilisateur actuel doit être membre du groupe Administrateurs sur l’ordinateur local.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Server

Spécifie le contrôleur de domaine à exécuter la commande. Si ce paramètre n’est pas spécifié, cette applet de commande sélectionne un contrôleur de domaine par défaut pour l’opération.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Vous ne pouvez pas diriger l’entrée vers cette applet de commande.

Sorties

Boolean

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

Notes

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