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