Partager via

Test-ComputerSecureChannel

Module:
Microsoft.PowerShell.Management Module

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

Syntaxe

Default (Par défaut) 

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.

Remarque

Cette applet de commande fonctionne uniquement sur les ordinateurs membres du domaine. Lorsque vous l’exécutez sur des contrôleurs de domaine, il retourne des erreurs fausses positives. Pour vérifier et réinitialiser les canaux sécurisés pour les contrôleurs de domaine, utilisez netdom.exe ou nltest.exe.

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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:PSCredential
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

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.

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.