Get-CsAdDomain
上次修改主題的時間： 2012-03-23
傳回資訊，指出是否已正確設定 Active Directory 網域服務 (AD DS)，以允許安裝 Microsoft Lync Server 2010。
語法
Get-CsAdDomain [-Domain <Fqdn>] [-DomainController <Fqdn>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>]
詳細描述
在安裝 Lync Server 2010 前，您必須先將網域準備好，包括擴充 Active Directory 架構以允許新增 Lync Server 特有的屬性，以及將所需的存取控制項目指派給用於管理與操作 Lync Server 的萬用群組。Get-CsAdDomain Cmdlet 會傳回單一值，告訴您是否可在網域上安裝 Lync Server。如果 Get-CsAdDomain 傳回 LC_DOMAINSETTINGS_STATE_READY 值，表示您可以將 Lync Server 安裝在該網域。如果 Cmdlet 傳回 LC_DOMAINSETTINGS_STATE_NOT_READY，則您必須先將網域正確的準備好，再嘗試安裝 Lync Server。
Get-CsAdDomain 作為安裝精靈的一部分執行。如果精靈判定網域未正確就緒，則會顯示錯誤訊息並停止安裝。但在嘗試安裝 Lync Server 之前，您可以單獨執行安裝精靈的 Get-CsAdDomain，以確認網域的狀態。
Get-CsAdDomain 執行的功能與下列 Microsoft Office Communications Server 2007 R2 命令相同：
Lcscmd.exe /domain /action:CheckDomainPrepState
誰可以執行這個指令程式：根據預設，任何擁有 Active Directory 之讀取權限的使用者均可執行 Get-CsAdDomain 指令程式。一般來說，所有網域成員均擁有此權限。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAdDomain"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Domain |
選用 |
字串 |
要檢查之網域的完整網域名稱 (FQDN)，例如：-Domain "litwareinc.com"。如果未指定此參數，則會檢查本端網域。 |
DomainController |
選用 |
字串 |
可讓系統管理員指定執行 Get-CsAdDomain 時所使用之網域控制站的 FQDN。如果未指定，指令程式會使用第一個可用的網域控制站。 |
GlobalCatalog |
選用 |
字串 |
網域中的通用類別目錄伺服器的 FQDN。如您正在網域內的電腦上，以帳戶執行 Get-CsAdDomain，則不需要這個參數。 |
GlobalSettingsDomainController |
選用 |
字串 |
儲存通用設定之網域控制站的 FQDN。如果通用設定是儲存在 Active Directory 的系統容器內，則此參數必須導向根網域控制器。如果通用設定儲存在組態容器中，則會使用任何一個網域控制站，且會省略此參數。 |
Report |
選用 |
字串 |
可讓您指定在指令程式執行時所建立記錄檔的檔案路徑。例如：-Report "C:\Logs\DomainPrep.html" |
輸入類型
無。Get-CsAdDomain 不會接受管線傳送的輸入。
傳回類型
Get-CsAdDomain 會傳回 Microsoft.Rtc.Management.Deployment.LcDomainSettingsState 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Get-CsAdDomain
上述範例會傳回與本機 Active Directory 網域之目前狀態相關的資訊。如果您的網域設定是最新的，且網域已準備好裝載 Lync Server 2010，則會傳回 LC_DOMAIN_SETTINGS_STATE_READY 值。
-------------------------- 範例 2 --------------------------
Get-CsAdDomain -Domain "fabrikam.com"
範例 2 的命令會傳回特定網域的目前狀態：fabrikam.com。在多網域環境中，您可以藉由包含 Domain 參數來傳回指定網域的資訊。
-------------------------- 範例 3 --------------------------
Get-CsAdDomain -Report "C:\Logs\DomainReport.html"
範例 3 會擷取您 Active Directory 網域的目前狀態，同時還會將狀態的相關資訊寫入名為 C:\Logs\DomainReport.html 檔案中，這個檔案會說明 Get-CsAdDomain 採取了哪些步驟來判定網域的準備狀態。這些步驟包括驗證 Active Directory 群組是否存在，以及檢查各種 Active Directory 容器權限設定等工作。