Prueba y repara el canal seguro entre el equipo local y su dominio.
Sintaxis
Test-ComputerSecureChannel [-Repair] [-Server <string>] [-Confirm] [-WhatIf] [<CommonParameters>]
Descripción
El cmdlet Test-ComputerSecureChannel se asegura de que el canal seguro entre el equipo local y su dominio esté funcionando correctamente comprobando el estado de sus relaciones de confianza. Si se produce un error en una conexión, se puede utilizar el parámetro Repair para intentar restaurarla.
Test-ComputerSecureChannel devuelve "True" si el canal seguro está funcionando correctamente y "False" si no lo está. Este resultado permite utilizar el cmdlet en instrucciones condicionales de funciones y scripts. Para obtener resultados de pruebas más detallados, utilice el parámetro Verbose.
Este cmdlet funciona de forma parecida a NetDom.exe. Tanto NetDom como Test-ComputerSecureChannel utilizan el servicio NetLogon para realizar las acciones.
Parámetros
-Repair
Quita y a continuación regenera el canal seguro establecido por el servicio NetLogon. Utilice este parámetro para intentar restaurar una conexión que no haya superado la prueba (valor devuelto "False").
Para utilizar este parámetro, el usuario actual debe ser miembro del grupo Administradores en el equipo local.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
ninguno |
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Server <string>
Utiliza el controlador de dominio especificado para ejecutar el comando. Si se omite este parámetro, Test-ComputerSecureChannel selecciona un controlador de dominio predeterminado para la operación.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
ninguno |
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Confirm
Solicita confirmación antes de ejecutar el comando.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-WhatIf
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
|
Entradas |
Ninguno No se pueden canalizar entradas a este cmdlet. |
|
Salidas |
System.Boolean El cmdlet devolverá "True" cuando la conexión esté funcionando correctamente y "False" cuando no lo esté. |
Notas
Para ejecutar un comando Test-ComputerSecureChannel en Windows Vista y versiones posteriores de Windows, abra Windows PowerShell con la opción "Ejecutar como administrador".
Test-ComputerSecureChannel se implementa utilizando la función I_NetLogonControl2, que controla diversos aspectos del servicio Netlogon.
Ejemplo 1
C:\PS>test-computersecurechannel True Descripción ----------- Este comando prueba el canal seguro entre el equipo local y el dominio al que está unido.
Ejemplo 2
C:\PS>test-computersecurechannel -server DCName.fabrikam.com True Descripción ----------- Este comando especifica un controlador de dominio preferido para la prueba.
Ejemplo 3
C:\PS>Test-ComputerSecureChannel -repair True Descripción ----------- Este comando restablece el canal seguro entre el equipo local y su dominio.
Ejemplo 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." Descripción ----------- Este comando utiliza el parámetro común Verbose para solicitar mensajes detallados sobre la operación. Para obtener más información sobre el parámetro Verbose, vea about_CommonParameters.
Ejemplo 5
C:\PS>set-alias tcsc test-computersecurechannel
if (!(tcsc))
{write-host "Connection failed. Reconnect and retry."}
else { &(.\get-servers.ps1) }
Descripción
-----------
En este ejemplo se muestra la forma de utilizar Test-ComputerSecureChannel para probar una conexión antes de ejecutarse un script que requiere la conexión.
El primer comando utiliza el cmdlet Set-Alias para crear un alias para el nombre de cmdlet. De este modo se ahorra espacio y se evitan errores tipográficos.
La instrucción If comprueba el valor que Test-ComputerSecureChannel devuelve antes de ejecutarse un script.
Vea también