Get-CsAdDomain
Última modificación del tema: 2012-03-23
Devuelve información que indica si Active Directory Domain Services (AD DS) se ha configurado correctamente para permitir la instalación de Microsoft Lync Server 2010.
Sintaxis
Get-CsAdDomain [-Domain <Fqdn>] [-DomainController <Fqdn>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>]
Descripción detallada
Para poder instalar Lync Server 2010, el dominio debe estar preparado correctamente, proceso que conlleva tanto extender el esquema de Active Directory (para que sea posible agregar atributos específicos de Lync Server) como asignar las entradas de control de acceso requeridas a los grupos universales usados para la administración y el funcionamiento de Lync Server. El cmdlet Get-CsAdDomain devuelve un solo valor que le indica si Lync Server puede instalarse en un dominio. Si Get-CsAdDomain devuelve el valor LC_DOMAINSETTINGS_STATE_READY, podrá instalar Lync Server en dicho dominio. Si el cmdlet devuelve LC_DOMAINSETTINGS_STATE_NOT_READY, necesitará preparar correctamente el dominio antes de intentar la instalación de Lync Server.
Get-CsAdDomain se ejecuta como parte del Asistente para la instalación. Si el asistente determina que el dominio no está preparado correctamente, se mostrará un mensaje de error y se detendrá la instalación. Sin embargo, puede ejecutar Get-CsAdDomain de manera independiente del Asistente para la instalación para comprobar el estado del dominio antes de intentar instalar Lync Server.
Get-CsAdDomain realiza la misma función que el siguiente comando de Microsoft Office Communications Server 2007 R2:
Lcscmd.exe /domain /action:CheckDomainPrepState
Quién puede ejecutar este cmdlet: de forma predeterminada, cualquier usuario con permisos de lectura en Active Directory (que suelen poseer todos los miembros de dominio) puede ejecutar el cmdlet Get-CsAdDomain.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAdDomain"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Domain |
Opcional |
Cadena de caracteres |
Nombre de dominio completo (FQDN) del dominio que se va a comprobar, por ejemplo: -Domain "litwareinc.com". Si no se especifica este parámetro, se comprobará el dominio local. |
DomainController |
Opcional |
Cadena de caracteres |
Permite que los administradores especifiquen el FQDN del controlador del dominio que se va a usar cuando se ejecute Get-CsAdDomain. Si no está especificado, el cmdlet usará el primer controlador de dominio disponible. |
GlobalCatalog |
Opcional |
Cadena de caracteres |
FQDN de un servidor de catálogo global del dominio. Este parámetro no es obligatorio si ejecuta Get-CsAdDomain en un equipo con una cuenta de su dominio. |
GlobalSettingsDomainController |
Opcional |
Cadena de caracteres |
FQDN de un controlador de dominio donde esté almacenada la configuración global. Si la configuración global se almacena en el contenedor del sistema de Active Directory, este parámetro debe hacer referencia al controlador de dominio raíz. Si la configuración global está almacenada en el contenedor de configuración, se puede usar cualquier controlador de dominio y omitir este parámetro. |
Report |
Opcional |
Cadena de caracteres |
Permite especificar la ruta de acceso del archivo de registro que se crea al ejecutarse el cmdlet. Por ejemplo: -Report "C:\Logs\DomainPrep.html" |
Tipos de entrada
Ninguno. Get-CsAdDomain no acepta entradas transferidas.
Tipos de valores devueltos
Get-CsAdDomain devuelve instancias del objeto Microsoft.Rtc.Management.Deployment.LcDomainSettingsState.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsAdDomain
En el ejemplo anterior se devuelve información relacionada con el estado actual del dominio local de Active Directory. Si los valores del dominio están actualizados y si el dominio está preparado para hospedar Lync Server 2010, se devolverá el valor LC_DOMAIN_SETTINGS_STATE_READY.
-------------------------- Ejemplo 2 --------------------------
Get-CsAdDomain -Domain "fabrikam.com"
El comando que se muestra en el Ejemplo 2 devuelve el estado actual de un dominio específico: fabrikam.com. En un entorno con varios dominios, puede devolver información de un dominio concreto si incluye el parámetro Domain.
-------------------------- Ejemplo 3 --------------------------
Get-CsAdDomain -Report "C:\Logs\DomainReport.html"
En el ejemplo 3 se recupera el estado actual del dominio de Active Directory y, al mismo tiempo, se escribe información acerca de dicho estado en un archivo llamado C:\Logs\DomainReport.html. Este archivo detallará los pasos que Get-CsAdDomain realiza para determinar el estado de preparación del dominio. Estos pasos engloban tareas como la comprobación de la existencia de grupos de Active Directory y la comprobación de valores de permiso en varios contenedores de Active Directory.