Set-CsSimpleUrlConfiguration
上次修改主題的時間： 2012-10-17
修改現有的簡易 URL 組態集合。簡易 URL 讓使用者較容易加入會議，並讓系統管理員更容易登入 Microsoft Lync Server 2010 控制台。
語法
Set-CsSimpleUrlConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-SimpleUrl <PSListModifier>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]
Set-CsSimpleUrlConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-SimpleUrl <PSListModifier>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]
詳細描述
在 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 組態集合是使用 New-CsSimpleUrlConfiguration 指令程式建立的，您之後可以使用其他的指令程式 (例如 New-CsSimpleUrl 和 Set-CsSimpleUrlConfiguration) 將簡易 URL 填入到這些集合中。建立集合之後，Set-CsSimpleUrlConfiguration 也會為您提供修改這些集合中所儲存之 URL 的能力。
將簡易 URL 新增至集合相當簡單。一開始，您使用 New-CsSimpleUrl 和 New-CsSimpleUrlEntry 來建立只存在記憶體內的 URL。然後使用 Add 命令，將新的 URL 新增至現有的集合。或者，可以使用 Replace 方法，利用新的 URL 來取代所有現有的 URL。
從集合中移除 URL 就有點困難；這是因為您必須先建立該 URL (模擬現有 URL 的那一個) 的新物件參照，然後使用該物件參照和 Remove 方法來刪除 URL。
更新簡易 URL 後，接著您必須執行 Enable-CsComputer 指令程式。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsSimpleUrlConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsSimpleUrlConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
要修改之簡易 URL 集合的唯一識別碼。若要修改通用集合，請使用下列語法：-Identity global。若要從站台範圍修改集合，請使用類似下列的語法：-Identity "site:Redmond." 如果未指定此參數，將會修改通用集合。 |
Instance |
選用 |
SimpleUrlConfiguration 物件 |
允許您將物件參照傳遞給 Cmdlet，而不設定個別參數值。 |
SimpleUrl |
選用 |
PS 清單修改程式 |
針對此集合設定的簡易 URL。必須使用 New-SimpleUrl 和 New-SimpleUrlEntry 指令程式建立這些 URL。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
Tenant |
選用 |
Guid |
這個參數不會與內部部署的 Lync Server 2010 版本搭配使用。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration 物件。Set-CsSimpleUrlConfiguration 會接受 Simple URL 組態物件的管線傳送執行個體。
傳回類型
無。
範例
-------------------------- 範例 1 ------------------------
Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl $Null
範例 1 所示的命令會從 Redmond 站台移除所有的簡易 URL，但不會移除簡易 URL 的實際集合 (此集合仍會存在，但不再包含任何 URL)。為達成此目的，命令會使用 SimpleUrl 參數並將參數值設定為 Null 值 ($Null)。這會從集合中移除所有的簡易 URL。
-------------------------- 範例 2 ------------------------
$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；SimpleUrl 屬性設為 $urlEntry，而 $urlEntry 是第一個命令中建立的 URL 項目。
在 URL 建立 (並儲存在物件參考 $simpleUrl 中) 後，範例中的最後一個命令會將新的 URL 新增至 Redmond 站台的簡易 URL 集合。這可以透過使用 Set-CsSimpleUrlConfiguration 指令程式、SimpleUrl 參數和參數值 @{Add=$simpleUrl} 完成。此語法會使儲存在物件參考 $simpleUrl 中的 URL 新增至 SimpleUrl 屬性。
-------------------------- 範例 3 ------------------------
$urlEntry = New-CsSimpleUrlEntry -Url "https://fabrikam.vdomain.com"
$simpleUrl = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrlEntry $urlEntry -ActiveUrl "https://meet.fabrikam.com"
Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Remove=$simpleUrl}
範例 3 所示的命令示範您如何從簡易 URL 集合中刪除單一 URL。由於 Set-CsSimpleUrlConfiguration 需要與 URL 物件一起運作，因此範例一開始便會建立包含與要刪除 URL 完全相同之屬性值的新物件。作法上第一個命令會使用 New-CsSimpleUrlEntry，來建立指向 https://meet.fabrikam.com 的 URL 項目；此 URL 項目儲存於名為 $urlEntry 的變數中。
建立 URL 項目之後，第二個命令會使用 New-CsSimpleUrl，建立的簡易 URL 之只存在記憶體內的執行個體。在此範例中，將 URL Component 設定為 Meet；將網域設定為 fabrikam.com；將 ActiveUrl 設定為 https://meet.fabrikam.com；以及將 SimpleUrl 屬性設定為 $urlEntry，$urlEntry 是第一個命令中建立的 URL 項目。這會建立記憶體內的 URL ($simpleUrl)，該 URL 具備與要刪除之 URL 相同的屬性值。
然後範例中的最後一個命令會從適用於 Redmond 站台的簡易 URL 集合中刪除該 URL。這可以使用 Set-CsSimpleUrlConfiguration 指令程式、SimpleUrl 參數及參數值 @{Remove=$simpleUrl} 來完成。此語法只是使儲存於物件參照 $simpleUrl 中的 URL 從 SimpleUrl 屬性中移除。