Get-CsAdForest

 

上一次修改主题： 2012-03-23

返回指示是否已正确配置您的 Active Directory 林以允许安装 Microsoft Lync Server 2010 的信息。

语法

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

详细说明

在安装 Lync Server 2010 之前，必须对 Active Directory 域服务 (AD DS) 进行多项林级更改。这包括创建特定于 Lync Server 的显示说明符和对象，创建管理 Lync Server 所需的通用安全组，以及为这些组授予全局设置对象访问权限。Get-CsAdForest cmdlet 会返回一个值，以指示是否可以将 Lync Server 安装在林中。如果 Get-CsAdForest 返回的值是 LC_FORESTSETTINGS_STATE_READY，则您可以在林中安装 Lync Server。如果该 cmdlet 返回 LC_FORESTSETTINGS_STATE_NOT_READY，则首先需要正确准备好林，然后再尝试安装 Lync Server。

Get-CsAdForest 作为安装向导的一部分运行；如果向导确定没有正确准备林，您将收到错误消息，并且将停止安装。但是，在尝试安装 Lync Server 之前，您可以独立于安装向导运行 Get-CsAdForest 以验证林状态。

Get-CsAdForest 与以下 Microsoft Office Communications Server 2007 R2 命令执行相同的功能：

Lcscmd.exe /forest /action:CheckForestPrepState

谁能运行此 cmdlet：默认情况下，对 Active Directory 具有读取权限的任何用户都可以在本地运行 Get-CsAdForest cmdlet。通常，所有域成员均拥有该权限。

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

参数

参数	必需	类型	描述
GlobalCatalog	可选	字符串	域中的全局编录服务器的完全限定域名 (FQDN)。如果正在计算机上使用您的域中的帐户运行 Get-CsAdForest，则不需要指定此参数。
GlobalSettingsDomainController	可选	字符串	用于存储全局设置的域控制器的 FQDN。如果全局设置存储在 AD DS 的“系统”容器中，则此参数必须指向根域控制器。如果全局设置存储在“配置”容器中，则可以使用任何域控制器，并且可以省略此参数。
RootDomainController	可选	字符串	根域控制器的 FQDN，用来为需要访问非自己的域中的资源的客户端创建可信路径。
Report	可选	字符串	用于指定在该 cmdlet 运行时创建的日志文件的文件路径。例如：-Report "C:\Logs\ForestPrep.html"
SkipPrepareCheck	可选	布尔值	设置为 True ($True) 时，Get-CsAdForest 在运行前不先进行其初始准备检查。

输入类型

无。

返回类型

Get-CsAdForest 返回 Microsoft.Rtc.Management.Deployment.LcForestSettingsState 对象的实例。

示例

-------------------------- 示例 1 --------------------------

Get-CsAdForest

上述示例返回指示是否已正确配置您的 Active Directory 林以允许安装 Lync Server 的信息。

-------------------------- 示例 2 --------------------------

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

在示例 2 中，返回林状态信息，并在屏幕上显示林准备情况。此外，有关确定林状态所采取的相应步骤的详细信息已写入到名称为 C:\Logs\ForestState.html 的文件中。该文件包含用于验证权限的所有 Active Directory 组和 Active Directory 容器的详细列表。