Get-CsSimpleUrlConfiguration
上次修改主題的時間： 2012-03-23
傳回關於已設定為在組織中使用之簡單 URL 的資訊。簡單 URL 讓使用者較容易加入會議，並讓系統管理員更容易登入 Microsoft Lync Server 2010 控制台。
語法
Get-CsSimpleUrlConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
Get-CsSimpleUrlConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
詳細描述
在 Microsoft Office Communications Server 2007 R2 中，會議具有類似下列的 URL：
不過，這種 URl 不是很直覺，不容易傳達給其他人。Lync Server 2010 中採用的簡單 URL 提供類似下列的 URL 給使用者，有助於克服這些問題：
https://meet.litwareinc.com/kenmyer/071200
Simple URL 為 Office Communications Server 中使用的 URL 進行改進。但是系統不會自動建立簡單 URL；而是您必須自行設定 URL。(您也必須為每個 URL 建立網域名稱系統 (DNS) 記錄；設定外部存取的反向 Proxy 規則；將 Simple URL 新增至您的前端伺服器憑證等等)。
Lync Server 可讓您建立三個不同的簡單 URL：
Meet – 用於會議。您的每個 SIP 網域都必須至少有一個 Meet URL。
Admin – 用於將系統管理員指向 Lync Server 2010 控制台。
Dialin – 用於電話撥入式會議網頁。
簡單 URL 儲存在簡單 URL 組態集合中。當您安裝 Lync Server 後，系統會建立通用集合，您也可以在網站範圍建立自訂集合。這讓您能夠在每個網站使用不同的簡單 URL。
Get-CsSimpleUrlConfiguration 指令程式提供一種方式，讓您擷取目前用於組織之所有簡單 URL 組態集合的相關資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsSimpleUrlConfiguration Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsSimpleUrlConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
Xds 識別 |
要傳回之簡單 URL 集合的唯一識別碼。若要傳回通用集合，請使用此語法：-Identity global。若要傳回網站範圍的集合，請使用類似如下的語法：-Identity "site:Redmond"。請注意，指定 Identity 時，無法使用萬用字元。如果要使用萬用字元，請改用 Filter 參數。 呼叫不含任何參數的 Get-CsSimpleUrlConfiguration 會傳回設定用於組織的所有簡單 URL。 |
Filter |
選用 |
字串 |
可讓您使用萬用字元指定要傳回的簡單 URL 集合。例如，以下語法會傳回已在網站範圍設定的所有簡單 URL 集合：-Filter "site:*"。 請注意，您不能在同一個命令中同時使用 Filter 和 Identity 參數。 |
Tenant |
選用 |
Guid |
這個參數不會與內部部署的 Lync Server 2010 版本搭配使用。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區的本機複本擷取 Simple URL 組態資料，而非從中央管理存放區本身擷取。 |
輸入類型
無。
傳回類型
Get-CsSimpleUrlConfiguration 會傳回 Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsSimpleUrlConfiguration
以上的命令會傳回組織中目前使用之所有簡單 URL 組態集合的相關資訊。這可以透過呼叫不包含任何額外參數的 Get-CsSimpleUrlConfiguration 達成。
-------------------------- 範例 2 ------------------------
Get-CsSimpleUrlConfiguration -Identity "site:Redmond"
在範例 2 中，會傳回單一簡單 URL 組態集合的資訊：Identity 為 site:Redmond 的組態。
-------------------------- 範例 3 ------------------------
Get-CsSimpleUrlConfiguration -Filter "site:*"
範例 3 會傳回已指派給網站範圍之所有簡單 URL 組態集合的相關資訊。若要完成此作業，會呼叫 Get-CsSimpleUrlConfiguration 並搭配 Filter 參數；篩選值 "site:*" 會將傳回的資料限制為 Identity 開頭為字串值 "site:" 的集合。
-------------------------- 範例 4 ------------------------
Get-CsSimpleUrlConfiguration | Select-Object -ExpandProperty SimpleUrl
在範例 4 中，會顯示設定用於組織之每個簡單 URL 的詳細資訊。若要執行此工作，此命令會先呼叫 Get-CsSimpleUrlConfiguration 以傳回一組完整的簡單 URL 資訊。然後，此資料會傳送到 Select-Object 指令程式，以使用 ExpandProperty 參數來「展開」SimpleUrl 屬性的值。展開屬性值只會以易讀的格式顯示該屬性中儲存的所有資料。
-------------------------- 範例 5 ------------------------
Get-CsSimpleUrlConfiguration | Select-Object -ExpandProperty SimpleUrl | Where-Object {$_.Component -eq "Meet"}
範例 5 所示的命令會傳回組織中目前使用之會議管理的所有 Simple URL。為達成此目的，此命令會先呼叫不含任何額外參數的 Get-CsSimpleUrlConfiguration；這樣會傳回一組完整的簡單 URL 資訊。然後，此資料會傳送到 Select-Object 指令程式，以使用 ExpandProperty 參數來展開 SimpleUrl 屬性的值。接著，這個篩選過的集合會傳送到 Where-Object，只挑出 Component 屬性等於 "Meet" 的 Simple URL。