Teste et répare le canal sécurisé entre l'ordinateur local et son domaine.
Syntaxe
Test-ComputerSecureChannel [-Repair] [-Server <string>] [-Confirm] [-WhatIf] [<CommonParameters>]
Description
L'applet de commande Test-ComputerSecureChannel vérifie que le canal sécurisé entre l'ordinateur local et son domaine fonctionne correctement en contrôlant l'état de ses relations d'approbation. En cas d'échec d'une connexion, vous pouvez utiliser le paramètre Repair pour essayer de la restaurer.
Test-ComputerSecureChannel retourne « True » lorsque le canal sécurisé fonctionne correctement et « False » dans le cas contraire. Ce résultat vous permet d'utiliser l'applet de commande dans des instructions conditionnelles dans des fonctions et des scripts. Pour obtenir des informations détaillées sur les résultats des tests, utilisez le paramètre Verbose.
Cette applet de commande fonctionne un peu comme NetDom.exe. NetDom et Test-ComputerSecureChannel utilisent le service NetLogon pour exécuter les actions.
Paramètres
-Repair
Supprime, puis reconstruit, le canal sécurisé établi par le service NetLogon. Utilisez ce paramètre pour essayer de restaurer une connexion dont le test a échoué (« False » a été retourné).
Pour utiliser ce paramètre, l'utilisateur actuel doit être membre du groupe Administrateurs sur l'ordinateur local.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
aucun |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Server <string>
Utilise le contrôleur de domaine spécifié pour exécuter la commande. Si ce paramètre est omis, Test-ComputerSecureChannel sélectionne un contrôleur de domaine par défaut pour l'opération.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
aucun |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Confirm
Vous invite à confirmer l'exécution de la commande.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-WhatIf
Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
|
Entrées |
None Vous ne pouvez pas diriger d'entrée vers cette applet de commande. |
|
Sorties |
System.Boolean L'applet de commande retourne « True » lorsque la connexion fonctionne correctement et « False » dans le cas contraire. |
Remarques
Pour exécuter une commande Test-ComputerSecureChannel sur Windows Vista et les versions ultérieures de Windows, ouvrez Windows PowerShell avec 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.
Exemple 1
C:\PS>test-computersecurechannel True Description ----------- Cette commande teste le canal sécurisé entre l'ordinateur local et le domaine auquel il est joint.
Exemple 2
C:\PS>test-computersecurechannel -server DCName.fabrikam.com True Description ----------- Cette commande spécifie un contrôleur de domaine par défaut pour le test.
Exemple 3
C:\PS>Test-ComputerSecureChannel -repair True Description ----------- Cette commande restaure le canal sécurisé entre l'ordinateur local et son domaine.
Exemple 4
C:\PS>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." Description ----------- Cette commande utilise le paramètre courant Verbose pour demander des informations détaillées sur l'opération. Pour plus d'informations sur le paramètre Verbose, consultez about_CommonParameters.
Exemple 5
C:\PS>set-alias tcsc test-computersecurechannel
if (!(tcsc))
{write-host "Connection failed. Reconnect and retry."}
else { &(.\get-servers.ps1) }
Description
-----------
Cet exemple montre comment utiliser Test-ComputerSecureChannel pour tester une connexion avant d'exécuter un script qui requiert 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 frappe.
L'instruction If vérifie la valeur retournée par Test-ComputerSecureChannel avant d'exécuter un script.
Voir aussi