Test-ComputerSecureChannel

Referencia

Módulo:: Microsoft.PowerShell.Management

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

Syntax

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 a NetDom.exe. 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: Prueba de 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, vea about_CommonParameters.

Ejemplo 5: Prueba de 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.

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

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.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	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 el que devuelve 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.

Type:	PSCredential
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Repair

Indica que este cmdlet quita y, a continuación, 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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

Ninguno

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 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.