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 容器的詳細清單。