Set-CsHostingProvider
上次修改主題的時間： 2012-03-26
修改目前用於組織的代管供應商。代管供應商是第三方組織，可提供立即訊息、目前狀態，以及與您想要同盟之網域相關的服務。代管供應商 (例如 Microsoft Lync Online 2010) 不同於公用提供者 (例如 Yahoo!、MSN 和 AOL)，因為其服務並非提供給一般大眾。
語法
Set-CsHostingProvider [-Identity <XdsGlobalRelativeIdentity>] [-AutodiscoverUrl <String>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-EnabledSharedAddressSpace <$true | $false>] [-Force <SwitchParameter>] [-HostsOCSUsers <$true | $false>] [-IsLocal <$true | $false>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-WhatIf [<SwitchParameter>]]
Set-CsHostingProvider [-AutodiscoverUrl <String>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-EnabledSharedAddressSpace <$true | $false>] [-Force <SwitchParameter>] [-HostsOCSUsers <$true | $false>] [-Instance <PSObject>] [-IsLocal <$true | $false>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-WhatIf [<SwitchParameter>]]
詳細描述
同盟是兩個組織用來建立信任關係的方法，以促進兩個群組之間的溝通。建立同盟後，兩個組織的使用者便可互相傳送立即訊息、訂閱目前狀態通知，並使用如 Lync 2010 等 SIP 應用程式互相通訊。Microsoft Lync Server 2010 允許三種同盟：1) 您組織與其他組織之間的直接同盟；2) 您組織與公共供應商之間的同盟；3) 您組織與第三方代管供應商之間的同盟。
代管供應商是為其他組織提供 SIP 通訊服務的組織；例如 Fabrikam, Inc. 可能為 Contoso、Northwind Traders、Wingtip Toys 的使用者提供主機服務。當您與代管供應商建立同盟關係時，便能夠有效率地與該供應商所託管的任何組織建立同盟關係。例如，如果您與 Fabrikam Hosting 同盟，您的使用者便能夠與 Contoso、Northwind Traders 及 Wingtip Toys 的使用者交換立即訊息和目前狀態的資訊。
代管供應商也用於分割網域案例。在分隔網域的案例中，您的部分 Lync Server 2010 使用者會擁有在內部主控的帳戶 (也就是在 Lync Server 的本機實作上進行主控)。其他使用者的帳戶由第三方代管供應商在外部部署維護。與代管供應商同盟可讓內部部署使用者與外部部署使用者互相通訊。
為了與第三方代管供應商同盟，您必須建立並啟用新的代管供應商(此外，第三方供應商必須與您建立同盟關係)。建立代管供應商後，您可以使用 Set-CsHostingProvider 指令程式修改該供應商的屬性。例如，您可以使用這個指令程式變更供應商 Proxy 伺服器的完整網域名稱 (FQDN)，或使用指令程式變更該供應商的驗證層級。
請注意，如果您的 Edge Server 設定為使用預設路由，而非網域名稱系統 (DNS) 伺服器路由，則您無法與代管供應商同盟。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsHostingProvider Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsHostingProvider"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
字串 |
要修改之代管供應商的唯一識別碼。Identity 可能是代管供應商的 FQDN (例如 fabrikam.com)，或是提供服務的公司名稱 (Fabrikam, Inc.)。 |
Instance |
選用 |
DisplayHostingProvider 物件 |
允許您將物件參照傳遞給 Cmdlet，而不設定個別參數值。 |
AutoDiscoverUrl |
選用 |
字串 |
託管 Lync Server 帳戶的代管供應商所使用之自動探索服務的 URL。自動探索服務可讓用戶端應用程式 (例如 Microsoft Lync Mobile) 決定如何存取使用者的主集區等資源。 |
Enabled |
選用 |
布林值 |
指出網域和代管供應商之間的網路連線是否已啟用。只有將此值設為 True，才能在兩個組織之間交換訊息。預設值為 False。 |
EnabledSharedAddressSpace |
選用 |
布林值 |
若為 True，則指出該代管供應商將用於分隔網域案例中。預設值為 False。 |
HostsOCSUsers |
選用 |
布林值 |
若為 True，則指出該代管供應商用於託管 Lync Server 2010 帳戶。若為 False，則指出該供應商託管其他帳戶類型，例如 Microsoft Exchange Server 帳戶。預設值為 False。 |
IsLocal |
選用 |
布林值 |
若為 True，則指出代管供應商使用的 Proxy 伺服器被包含在您自己的 Lync Server 拓撲內。預設值為 False。 |
VerificationLevel |
選用 |
字串 |
指出傳送至代管供應商或從代管供應商發出之訊息的允許驗證層級。驗證層級必須設為下列其中一個值： AlwaysVerifiable。指出從代管供應商發出的所有訊息都視為可驗證。這表示從代管供應商所發出的所有訊息都不會被拒絕。 AlwaysUnverifiable。指出從代管供應商發出的所有訊息都視為無法驗證。因此，只有在代管供應商上的使用者也在您的連絡人清單上，才會傳遞訊息。 UseSourceVerification。依賴包含在代管供應商發出之訊息內的驗證層級。如果沒有指定這個層級，訊息會視為無法驗證而被拒絕。 預設值為 AlwaysVerifiable。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider 物件。Set-CsHostingProvider 接受代管供應商物件管線傳送的執行個體。
傳回類型
Set-CsHostingProvider 不會傳回值或物件。反之，指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Set-CsHostingProvider -Identity "Fabrikam.com" -VerificationLevel "AlwaysUnverifiable"
上述命令修改包含 Identity 為 Fabrikam.com 的代管供應商。在此範例中，VerificationLevel 屬性會設為 AlwaysUnverifiable。
-------------------------- 範例 2 ------------------------
Get-CsHostingProvider | Set-CsHostingProvider -VerificationLevel "AlwaysUnverifiable"
範例 2 是範例 1 所示之命令的變化；不過，在此例中所有代管供應商的驗證層級都設為 AlwaysUnverifiable。為了執行這項作業，會先使用 Get-CsHostingProvider 傳回設定用於組織的所有代管供應商集合。此集合會傳送給 Set-CsHostingProvider，該指令程式會修改集合中每一個供應商的 VerificationLevel 屬性。
-------------------------- 範例 3 ------------------------
Get-CsHostingProvider | Where-Object {$_.EnabledSharedAddressSpace -eq $True -and $_.HostsOCSUsers -eq $True} | Set-CsHostingProvider -EnabledSharedAddressSpace $False -HostsOCSUsers $False
範例 3 會修改目前在分隔網域設定中設定使用的所有代管供應商，讓他們不再用於分隔網域同盟此範例會先呼叫 Get-CsHostingProvider，以便傳回所有可用代管供應商的集合。這個集合會被傳送到 Where-Object 指令程式，這樣只會選取那些符合兩個準則的供應商：1) HostsOCSUsers 屬性等於 True；且 2) EnabledSharedAddressSpace 屬性等於 True。這個篩選過的集合接著會傳送到 Set-CsHostingProvider，其可將 EnabledSharedAddressSpace 和 HostsOCSUsers 內容設為 False。完成之後，集合內的任何代管供應商將仍啟用同盟；但是不再使用於分隔網域案例中。