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 指令程式會傳回單一值，以告訴您是否可在樹系中安裝 Lync Server。如果 Get-CsAdForest 傳回值 LC_FORESTSETTINGS_STATE_READY，則您可在樹系中安裝 Lync Server。如果指令程式傳回 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

誰可以執行這個指令程式：根據預設，擁有 Active Directory 讀取權限的使用者可在本機執行 Get-CsAdForest 指令程式。一般來說，所有網域成員均擁有此權限。

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

參數

參數	必要	類型	描述
GlobalCatalog	選用	字串	網域中通用類別目錄伺服器的完整網域名稱 (FQDN)。如您正在網域內的電腦上，以帳戶執行 Get-CsAdForest，則不需要這個參數。
GlobalSettingsDomainController	選用	字串	儲存通用設定之網域控制站的 FQDN。如果通用設定是儲存在 AD DS 的系統容器內，則此參數必須導向根網域控制器。如果通用設定儲存在組態容器中，則會使用任何一個網域控制站，且會省略此參數。
RootDomainController	選用	字串	根網域控制站的 FQDN，針對需要存取本身以外網域中之資源的用戶端，用來建立信任路徑。
Report	選用	字串	可讓您指定在指令程式執行時所建立記錄檔的檔案路徑。例如：-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 容器的詳細清單。