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 Test-ComputerSecureChannel cmdlet 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 scripts y funciones. Para obtener resultados de pruebas más detallados, use el parámetro Verbose .

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

Ejemplos

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

Test-ComputerSecureChannel

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

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

Test-ComputerSecureChannel -Repair

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

Ejemplo 4: Mostrar información detallada sobre la prueba

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 parámetro común Detallado para solicitar mensajes detallados sobre la operación. Para obtener más información sobre Verbose, consulte about_CommonParameters.

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

if (!(Test-ComputerSecureChannel)) {
    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.

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

Parámetros

-Confirm

Le solicita su 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 con 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 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, debe pertenecer al grupo Administradores del 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 se ejecutara el cmdlet. 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 es.

Notas

  • Para ejecutar un Test-ComputerSecureChannel comando 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.