Compartir a través de

Test-ComputerSecureChannel

Módulo:
Microsoft.PowerShell.Management Module

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

Sintaxis

Default (valor predeterminado) 

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 para realizar las acciones.

Nota:

Este cmdlet solo funciona en equipos miembros del dominio. Al ejecutarlo en controladores de dominio, devuelve errores falsos positivos. Para comprobar y restablecer los canales seguros para controladores de dominio, use netdom.exe o nltest.exe.

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:PSCredential
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

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.