Get-CsAdForest

 

Última modificación del tema: 2012-03-23

Devuelve información que indica si su bosque de Active Directory se ha configurado correctamente para permitir la instalación de Microsoft Lync Server 2010.

Sintaxis

Get-CsAdForest [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-RootDomainController <Fqdn>] [-SkipPrepareCheck <$true | $false>]

Descripción detallada

Antes de poder instalar Lync Server 2010, debe realizar varios cambios en Active Directory Domain Services (AD DS) en el nivel de bosque. Esto incluye crear especificadores de presentación y objetos específicos de Lync Server, crear los grupos de seguridad universal necesarios para administrar Lync Server y conceder permisos de acceso de objetos de configuración global a estos grupos. El cmdlet Get-CsAdForest devuelve un solo valor que le indica si Lync Server puede instalarse en un bosque. Si Get-CsAdForest devuelve el valor LC_FORESTSETTINGS_STATE_READY, es posible instalar Lync Server en el bosque. Si el cmdlet devuelve LC_FORESTSETTINGS_STATE_NOT_READY, necesitará preparar correctamente el bosque antes de intentar instalar Lync Server.

Get-CsAdForest se ejecuta como parte del Asistente para instalación; si el Asistente determina que el bosque no está preparado correctamente, se mostrará un mensaje de error y el proceso de instalación se detendrá. Sin embargo, puede ejecutar Get-CsAdForest de manera independiente del Asistente de instalación para comprobar el estado del bosque antes de intentar instalar Lync Server.

Get-CsAdForest realiza la misma función que el siguiente comando de Microsoft Office Communications Server 2007 R2:

Lcscmd.exe /forest /action:CheckForestPrepState

Quién puede ejecutar este cmdlet: De forma predeterminada, todos los usuarios que tengan permisos de lectura de Active Directory pueden ejecutar localmente el cmdlet Get-CsAdForest. Normalmente, todos los miembros del dominio tienen este permiso.

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAdForest"}

Parámetros

Parámetro	Requerido	Tipo	Descripción
GlobalCatalog	Opcional	Cadena de caracteres	Nombre de dominio completo (FQDN) de un servidor de catálogo global del dominio. Este parámetro no es obligatorio si ejecuta Get-CsAdForest en un equipo con una cuenta de su dominio.
GlobalSettingsDomainController	Opcional	Cadena de caracteres	Nombre de dominio completo de un controlador de dominio donde están almacenadas las configuraciones globales. Si la configuración global está almacenada en el contenedor del sistema de AD DS, este parámetro debe apuntar al controlador del 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.
RootDomainController	Opcional	Cadena de caracteres	Nombre de dominio completo del controlador de dominio raíz, que se utiliza para crear rutas de confianza para clientes que necesitan acceso a recursos que se encuentran en un dominio que no es el suyo.
Report	Opcional	Cadena de caracteres	Permite especificar la ruta del archivo de registro creado al ejecutar el cmdlet. Por ejemplo: -Report "C:\Registros\ForestPrep.html"
SkipPrepareCheck	Opcional	Booleano	Cuando se establece en True ($True), provoca que Get-CsAdForest se ejecute sin realizar antes las comprobaciones de preparación iniciales.

Tipos de entrada

Ninguno.

Tipos de valores devueltos

Get-CsAdForest devuelve instancias del objeto Microsoft.Rtc.Management.Deployment.LcForestSettingsState.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

Get-CsAdForest

El ejemplo anterior devuelve información que indica si su bosque de Active Directory se ha configurado correctamente para permitir la instalación de Lync Server.

-------------------------- Ejemplo 2 --------------------------

Get-CsAdForest -Report C:\Logs\ForestState.html

En el Ejemplo 2 se devuelve información sobre el estado del bosque y se muestra en pantalla si está listo para la instalación. Además, se escribe en un archivo llamado C:\Logs\ForestState.html la información detallada sobre los pasos que se han tomado para averiguar el estado del bosque. Este archivo incluye una lista detallada de todos los grupos de Active Directory y los contenedores de Active Directory cuyos permisos se han verificado.