Set-CsTrustedApplicationEndpoint
上次修改主題的時間: 2012-03-25
修改信任之應用程式的現有端點連絡人。
語法
Set-CsTrustedApplicationEndpoint -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-Enabled <$true | $false>] [-EnabledForFederation <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-PrimaryLanguage <String>] [-SecondaryLanguages <MultiValuedProperty>] [-SipAddress <String>] [-Type <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
信任的應用程式端點是一個 Active Directory 連絡人物件,可將來電路由傳送至信任的應用程式。此指令程式移除 Active Directory 網域服務 (AD DS)中現有的端點連絡人物件。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Set-CsTrustedApplicationEndpoint Cmdlet:RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsTrustedApplicationEndpoint"}
參數
參數 | 必要 | 類型 | 說明 |
---|---|---|---|
Identity |
必要 |
使用者 ID 參數 |
要修改之應用程式端點的 Identity (辨別名稱) 或 SIP 位址。 |
DisplayName |
選用 |
字串 |
端點連絡人物件的顯示名稱。 |
DisplayNumber |
選用 |
字串 |
將顯示在通訊錄中之連絡人的電話號碼。 |
Enabled |
選用 |
布林值 |
決定是否針對 Lync Server 2010 啟用連絡人。 預設值:True |
EnabledForFederation |
選用 |
布林值 |
決定同盟使用者是否可以存取此連絡人。 預設值:False |
EnterpriseVoiceEnabled |
選用 |
布林值 |
決定是否針對 Enterprise Voice 啟用連絡人。 預設值:True |
LineURI |
選用 |
字串 |
連絡人的電話號碼。格式必須為 TEL:<number>,例如 TEL:+14255551212。 |
PrimaryLanguage |
選用 |
Int32 |
受信任應用程式所使用的主要語言。必須使用有效的語言代碼來設定該語言,例如 en-US (美國英文)、fr-FR (法文) 等等。 |
SecondaryLanguages |
選用 |
多值屬性 |
也可用於受信任應用程式的語言集合。必須將值設定為以逗號分隔的語言代碼清單。例如,下列語法可將法文 (加拿大) 和法文設為次要語言:-SecondaryLanguages "fr-CA","fr-FR"。 |
SipAddress |
選用 |
字串 |
您無法修改連絡人的 SIP 位址。建立應用程式端點時,會指派 SIP 位址。 |
Type |
選用 |
字串 |
此參數不會搭配這個指令程式使用。 |
PassThru |
選用 |
切換參數 |
加上此參數會讓指令程式不僅修改連絡人物件,而且會將新的物件當做輸出傳回。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact 物件。接受管線傳送的受信任應用程式端點物件輸入。
傳回類型
這個指令程式不會傳回值。它會修改 Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact 類型的物件。
範例
-------------------------- 範例 1 ------------------------
Set-CsTrustedApplicationEndpoint -Identity "sip:endpoint1@litwareinc.com" -DisplayName "Endpoint 1"
此範例會修改 SIP 位址為 endpoint1@litwareinc.com 的應用程式端點連絡人物件。請注意,Identity 值的開頭為字串 sip:,後面再接著 SIP 位址。下一個參數 DisplayName 已被指定值 “Endpoint 1”,它會將連絡人的顯示名稱變更為該值。
-------------------------- 範例 2 ------------------------
Get-CsTrustedApplicationEndpoint -Identity "Endpoint 1" | Set-CsTrustedApplicationEndpoint -DisplayNumber "(425)555-1212"
此範例會修改顯示名稱為 Endpoint 1 之端點應用程式的顯示號碼。此命令會從以 Identity 為 Endpoint 1 的 Get-CsTrustedApplicationEndpoint 呼叫開始。這樣會擷取具有該顯示名稱的端點連絡人物件。接著,此物件會傳送到 Set-CsTrustedApplicationEndpoint 指令程式,將 DisplayNumber 修改為此值,在此例中為 (425)555-1212。