New-CsSimpleUrlEntry
上次修改主題的時間: 2012-10-17
建立新的簡單 URL,建立簡單 URL 時需要此項目。簡單 URL 讓使用者較容易加入會議,並讓系統管理員更容易登入 Microsoft Lync Server 2010 控制台。
語法
New-CsSimpleUrlEntry -Url <String>
詳細描述
在 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 規則、將簡單 URL 新增至前端伺服器憑證等。
Lync Server 可讓您建立三個不同的簡單 URL:
Meet – 用於會議。您的每個 SIP 網域都必須至少有一個 Meet URL。
Admin – 用於將系統管理員指向 Lync Server 2010 控制台。
Dialin – 用於電話撥入式會議網頁。
簡單 URL 儲存在簡單 URL 組態集合中。當您安裝 Lync Server 後,系統會建立通用集合,您也可以在網站範圍建立自訂集合。這讓您能夠在每個網站使用不同的簡單 URL。
若要將實際 URL 新增至簡單 URL 集合,您必須先使用 New-CsSimpleUrl 和 New-CsSimpleUrlEntry 指令程式來建立 URL。New-CsSimpleUrlEntry 指令程式會建立一個 URL 項目;這不過是可當作簡單 URL (用於會議、管理或電話撥入式會議) 使用的 URL (例如 https://meet.litwareinc.com)。由 New-CsSimpleUrlEntry 建立的物件會新增至新簡單 URL 的 SimpleUrlEntry 屬性。您必須使用個別的指令程式來建立物件,因為 SimpleUrlEntry 屬性可以保留多個 URL。(不過,只有一個這類的 URL 可以被指定為使用中的 URL。使用中的 URL 代表用於會議、管理或電話撥入式會議的實際 URL)。
建立簡單 URL 項目後,接下來您可以使用 New-CsSimpleUrl 指令程式建立僅在記憶體中的簡單 URL 執行個體,並將其定義為元件 (簡單 URL 的類型)、網域、使用中的 URL,以及所有簡單 URL 項目。在您建立代表簡單 URL 的物件後,可以將該物件新增至新的或現有的簡單 URL 集合。更新簡單 URL 後,接著您必須執行 Enable-CsComputer 指令程式。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 New-CsSimpleUrlEntry Cmdlet:RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsSimpleUrlEntry"}
參數
參數 | 必要 | 類型 | 說明 |
---|---|---|---|
Url |
必要 |
字串 |
要新增至簡單 URL 之 SimpleUrlEntry 屬性的 URL。例如:-Url "https://meet.litwareinc.com"。URL 的開頭必須是 "https:"首碼。 |
輸入類型
無。
傳回類型
New-CsSimpleUrlEntry 會建立 Microsoft.Rtc.Management.WritableConfig.SimpleUtl.SimpleUrlEntry 物件的新執行個體。
範例
-------------------------- 範例 1 ------------------------
$urlEntry = New-CsSimpleUrlEntry -Url "https://meet.fabrikam.com"
$simpleUrl = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrlEntry $urlEntry -ActiveUrl "https://meet.fabrikam.com"
Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Add=$simpleUrl}
上述範例顯示如何將新的 URL 新增至簡單 URL 的現有集合中。一開始,範例的第一個命令會使用 New-CsSimpleUrlEntry,建立指向 https://meet.litwareinc.com 的 URL 項目;此 URL 項目儲存於名為 $urlEntry 的變數中。
在第二個命令中,New-CsSimpleUrl 用於僅在記憶體中建立簡單 URL 的執行個體。在此範例中,URL 元件設為 Meet;網域設為 litwareinc.com;ActiveUrl 設為 https://meet.litwareinc.com;SimpleUrlEntry 屬性設為 $urlEntry,而 $urlEntry 是第一個命令中建立的 URL 項目。
在 URL 建立 (並儲存在物件參考 $simpleUrl 中) 後,範例中的最後一個命令會將新的 URL 新增至 Redmond 網站的簡單 URL 集合。這可以透過使用 Set-CsSimpleUrlConfiguration 指令程式、SimpleUrl 參數和參數值 @{Add=$simpleUrl} 完成。此語法會使儲存在物件參考 $simpleUrl 中的 URL 新增至 SimpleUrl 屬性。
-------------------------- 範例 2 ------------------------
$urlEntry = New-CsSimpleUrlEntry -Url "https://meet.fabrikam.com"
$urlEntry2 = New-CsSimpleUrlEntry -Url "https://dialin.fabrikam.com"
$simpleUrl = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrl $urlEntry -ActiveUrl "https://meet.fabrikam.com"
$simpleUrl2 = New-CsSimpleUrl -Component "dialin" -Domain "*" -SimpleUrl $urlEntry -ActiveUrl "https://dialin.fabrikam.com"
Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Add=$simpleUrl, $simpleUrl2}
在範例 2 中,會將一組 URL 項目新增至現有簡單 URL 的集合。若要這樣做,範例中的第一個命令會使用 New-CsSimpleUrlEntry 建立一個指向 https://meet.fabrikam.com 的 URL 項目;此 URL 項目會以名稱為 $urlEntry 的變數儲存。接著,第二個命令會建立另一個 URL 項目,此項目會以名稱為 $urlEntry2 的變數儲存,並指向 URL https:// dialin.fabrikam.com。
建立這兩個 URL 項目後,New-CsSimpleUrl 會用於建立僅在記憶體中的簡單 URL 執行個體。在第一個執行個體中,URL 元件設為 Meet;網域設為 fabrikam.com;而 ActiveUrl 設為 https://meet.fabrikam.com。在第二個執行個體中,元件設為 Dialin;網域設為星號 (*);而 ActiveURL 內容設為 https://dialin.fabrikam.com。
建立 URL (並儲存於物件參照 $simpleUrl 和 $simpleUrl2 中) 之後,範例的最後一個命令會將新的 URL 新增至適用於 Redmond 網站的簡單 URL 集合中。這可以透過使用 Set-CsSimpleUrlConfiguration 指令程式、SimpleUrl 參數和參數值 @{Add=$simpleUrl, $simpleUrl2} 完成。此語法會導致儲存在物件中的 URL 參照 $simpleUrl,並將 $simpleUrl2 新增至 SimpleUrl 內容。