Get-DomainController

Referencia

Módulo:: ExchangePowerShell

Se aplica a:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Este cmdlet solo está disponible en el entorno local de Exchange.

Use el cmdlet Get-DomainController para ver una lista de los controladores de dominio que existen en su organización.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

Get-DomainController
   [-GlobalCatalog]
   [-Forest <Fqdn>]
   [-Credential <NetworkCredential>]
   [<CommonParameters>]

Get-DomainController
   [-DomainName <Fqdn>]
   [-Credential <NetworkCredential>]
   [<CommonParameters>]

Description

El centro de administración de Exchange usa el cmdlet Get-DomainController para rellenar los campos que muestran información del controlador de dominio.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

$UserCredentials = Get-Credential

Get-DomainController -DomainName corp.contoso.com -Credential $UserCredentials | Format-Table -AutoSize Name,ADSite

En este ejemplo se recupera una lista de servidores de catálogo global del dominio corp.contoso.com. Dado que se requiere un conjunto diferente de credenciales para acceder a este dominio, se usa el cmdlet Get-Credential para obtener el nombre de usuario y la contraseña del usuario.

El primer comando muestra un símbolo del sistema al usuario que acepta el nombre de usuario y la contraseña. A continuación, las credenciales se almacenan en la variable $UserCredentials. El segundo comando usa la variable $UserCredentials para el valor del parámetro Credential. Para hacer que la lista sea más legible, el resultado se canaliza al cmdlet Format-Table y sólo se muestran las propiedades de Name y ADSite.

Para obtener más información sobre la canalización y el cmdlet Format-Table, vea Acerca de las canalizaciones y Trabajo con la salida del comando.

Parámetros

-Credential

El parámetro Credential especifica el nombre de usuario y la contraseña que se usan para ejecutar este comando. Por lo general, este parámetro se usa en scripts o cuando deben proporcionarse credenciales diferentes que disponen de los permisos necesarios.

Este parámetro requiere la creación y el paso de un objeto de credenciales. Este objeto de credenciales se crea mediante el cmdlet Get-Credential. Para más información, vea Get-Credential.

Si usa el parámetro Forest, se usan las credenciales para obtener acceso al bosque.

Type:	NetworkCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainName

El parámetro DomainName especifica el nombre de dominio completo (FQDN) del dominio para el que desea devolver una lista de controladores de dominio.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Forest

El parámetro Forest especifica el FQDN del dominio raíz del bosque para el que desea devolver una lista de controladores de dominio.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-GlobalCatalog

El modificador GlobalCatalog especifica si el comando debe devolver una lista de servidores de catálogo global. No es necesario especificar un valor con este modificador.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.

Compartir a través de