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




Tabla de contenido