Compartir a través de

Test-ComputerSecureChannel

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Comprueba y repara el canal seguro entre el equipo local y su dominio.

Sintaxis

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

Description

El cmdlet Test-ComputerSecureChannel comprueba que el canal entre el equipo local y su dominio funciona correctamente comprobando el estado de sus relaciones de confianza. Si se produce un error en una conexión, puede usar el parámetro Repair para intentar restaurarla.

Test-ComputerSecureChannel devuelve $True si el canal funciona correctamente y $False si no lo está. Este resultado le permite usar el cmdlet en instrucciones condicionales en funciones y scripts. Para obtener resultados de pruebas más detallados, use el parámetro Verbose.

Este cmdlet funciona de forma muy similar a NetDom.exe. Tanto NetDom como Test-ComputerSecureChannel usan el servicio netLogon de para realizar las acciones.

Ejemplos

Ejemplo 1: Probar un canal entre el equipo local y su dominio

PS C:\> Test-ComputerSecureChannel
True

Este comando prueba el canal entre el equipo local y el dominio al que está unido.

Ejemplo 2: Probar un canal entre el equipo local y un controlador de dominio

PS C:\> Test-ComputerSecureChannel -Server "DCName.fabrikam.com"
True

Este comando especifica un controlador de dominio preferido para la prueba.

Ejemplo 3: Restablecer el canal entre el equipo local y su dominio

PS C:\> Test-ComputerSecureChannel -Repair
True

Este comando restablece el canal entre el equipo local y su dominio.

Ejemplo 4: Mostrar información detallada sobre la prueba

PS C:\> 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."

Este comando usa el verbose parámetro común para solicitar mensajes detallados sobre la operación. Para obtener más información sobre detallado, consulte about_CommonParameters.

Ejemplo 5: Probar una conexión antes de ejecutar un script

PS C:\> Set-Alias tcsc Test-ComputerSecureChannel
if (!(tcsc))
{Write-Host "Connection failed. Reconnect and retry."}
else { &(.\Get-Servers.ps1) }

En este ejemplo se muestra cómo usar Test-ComputerSecureChannel para probar una conexión antes de ejecutar un script que requiera la conexión.

El primer comando usa el cmdlet Set-Alias para crear un alias para el nombre del cmdlet. Esto ahorra espacio y evita errores de escritura.

La instrucción If comprueba el valor que Test-ComputerSecureChannel devuelve antes de ejecutar un script.

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Credential

Especifica una cuenta de usuario que tiene permiso para realizar esta acción. Escriba un nombre de usuario, como User01 o Domain01\User01, o escriba un objeto PSCredential , como uno que devuelva el cmdlet Get-Credential. De forma predeterminada, el cmdlet usa las credenciales del usuario actual.

El parámetro Credential está diseñado para su uso en comandos que usan el parámetro Repair de para reparar el canal entre el equipo y el dominio.

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Repair

Indica que este cmdlet quita y vuelve a generar el canal establecido por el servicio NetLogon. Use este parámetro para intentar restaurar una conexión que ha producido un error en la prueba.

Para usar este parámetro, el usuario actual debe ser miembro del grupo Administradores en el equipo local.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Server

Especifica el controlador de dominio para ejecutar el comando. Si no se especifica este parámetro, este cmdlet selecciona un controlador de dominio predeterminado para la operación.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

No se puede canalizar la entrada a este cmdlet.

Salidas

Boolean

Este cmdlet devuelve $True si la conexión funciona correctamente y $False si no lo está.

Notas

  • Para ejecutar un comando Test-ComputerSecureChannel en Windows Vista y versiones posteriores del sistema operativo Windows, abra Windows PowerShell mediante la opción Ejecutar como administrador.
  • Test-ComputerSecureChannel se implementa mediante la función I_NetLogonControl2, que controla varios aspectos del servicio Netlogon.