Get-CsUserDatabaseState
上次修改主題的時間： 2012-03-23
傳回一或多個 Microsoft Lync Server 2010 使用者資料庫之線上狀態的相關資訊 (True 或 False)。
語法
Get-CsUserDatabaseState [-Identity <String>]
Get-CsUserDatabaseState [-RegistrarPool <Fqdn>]
詳細描述
Lync Server 2010 會利用使用者資料庫 (亦稱為使用者存放區) 來維護 Lync Server 使用者的狀態和路由資訊。Get-CsUserDatabaseState 指令程式可讓您驗證組織中所有目前使用之使用者資料庫的現行狀態 (線上或離線)。
請注意，當您安裝 Lync Server 2010 標準版時，預設不會啟用 SQL Server Express 的防火牆例外。這表示您無法從 Windows PowerShell 的遠端執行個體執行 Get-CsUserDatabaseState。這是因為命令將無法周遊防火牆和存取 SQL Server Express 資料庫。您仍然可以本機執行此指令程式 (亦即，在 Standard Edition 伺服器上)。但是，若要遠端執行 Get-CsUserDatabaseState，您需要針對 SQL Server Express 手動啟用防火牆例外。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsUserDatabaseState Cmdlet：RTCUniversalServerAdmins。若要傳回指派給該指令程式的所有角色型存取控制 (RBAC) 角色清單 (包括您自己建立的任何自訂 RBAC 角色)，請在 Windows PowerShell 提示中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsUserDatabaseState"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
字串 |
要傳回線上狀態之使用者資料庫的唯一識別碼。例如：-Identity "UserDatabase:atl-sql-001.litwareinc.com"。 您不能在相同的命令中同時使用 Identity 和 RegistrarPool 兩者，也不能將任一參數搭配萬用字元使用。如果同時省略這兩個參數，Get-CsUserDatabaseState 會傳回所有目前正在使用之使用者資料庫的相關資訊。 |
RegistrarPool |
選用 |
字串 |
主控要傳回線上狀態之使用者資料庫的登錄器集區完整網域名稱。例如：-RegistrarPool "atl-cs-001.litwareinc.com"。 您不能在相同的命令中同時使用 Identity 和 RegistrarPool 兩者，也不能將任一參數搭配萬用字元使用。如果同時省略這兩個參數，Get-CsUserDatabaseState 會傳回所有目前使用之使用者資料庫的相關資訊。 |
輸入類型
無。Get-CsUserDatabaseState 不會接受管線傳送的輸入。
傳回類型
Get-CsUserDatabaseState 會傳回 Microsoft.Rtc.Management.Xds.UserStoreState 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsUserDatabaseState
範例 1 所示的命令會傳回每個針對在組織中使用而設定之使用者資料庫的線上狀態。
-------------------------- 範例 2 ------------------------
Get-CsUserDatabaseState -Identity "UserDatabase:atl-sql-001.litwareinc.com"
範例 2 所示的命令會傳回單一使用者資料庫的線上狀態：Identity 為 UserDatabase:atl-sql-001.litwareinc.com 的資料庫。
-------------------------- 範例 3 ------------------------
Get-CsUserDatabaseState -RegistrarPool "atl-cs-001.litwareinc.com"
在範例 3 中，此命令會傳回登錄器集區 atl-cs-001.litwareinc.com 中所有使用者資料庫的狀態資訊。
-------------------------- 範例 4 ------------------------
Get-CsUserDatabaseState | Where-Object {$_.Online -eq $True}
上述範例中的命令會傳回所有目前為線上狀態之使用者資料庫的資訊。為達成此目的，此命令會先呼叫 Get-CsUserDatabaseState 且不用任何其他參數。這樣會傳回在組織中使用的所有使用者資料庫集合。接著，這個集合會傳送到 Where-Object 指令程式；這樣只會挑出 Online 屬性等於 True 的資料庫。