Get-DomainController
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,ADSiteEn 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.