Compartilhar via

  • Artigo

Set-CsTrustedApplicationEndpoint

 

Tópico modificado em: 2012-03-25

Modifica um contato de ponto de extremidade existente para um aplicativo confiável.

Sintaxe

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>]]

Descrição Detalhada

Um ponto de extremidade de um aplicativo confiável é um objeto de contato do Active Directory que permite o roteamento de chamadas para um aplicativo confiável. Esse cmdlet modifica um objeto de contato de ponto de extremidade existente no Serviços de Domínio Active Directory (AD DS).

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsTrustedApplicationEndpoint localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsTrustedApplicationEndpoint"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

UserIdParameter

A Identidade (o nome diferenciado) ou endereço SIP do ponto de extremidade do aplicativo a ser modificado.

DisplayName

Opcional

Cadeia de caracteres

O nome para exibição do objeto de contato de ponto de extremidade.

DisplayNumber

Opcional

Cadeia de caracteres

O número do telefone do contato, conforme aparecerá no Catálogo de Endereços.

Enabled

Opcional

Booleano

Determina se o contato está habilitado para o Lync Server 2010.

Padrão: Verdadeiro

EnabledForFederation

Opcional

Booleano

Determina se os usuários federados terão acesso a esse contato.

Padrão: Falso

EnterpriseVoiceEnabled

Opcional

Booleano

Determina se o contato esta habilitado para o Enterprise Voice.

Padrão: Verdadeiro

LineURI

Opcional

Cadeia de caracteres

O número de telefone do contato. Deve estar no formato TEL:<número>; por exemplo, TEL:+14255551212.

PrimaryLanguage

Opcional

Int32

Idioma principal usado para o aplicativo confiável. O idioma deve ser configurado com um código de idioma válido, como en-US (inglês dos Estados Unidos), fr-FR (francês) etc.

SecondaryLanguages

Opcional

MultiValuedProperty

Uma coleção de idiomas que também podem ser usados para aplicativos confiáveis. Os valores devem ser configurados como uma lista de valores separados por vírgula dos códigos de idiomas. Por exemplo, a sintaxe a seguir define francês do Canadá e francês como idiomas secundários: -SecondaryLanguages "fr-CA","fr-FR".

SipAddress

Opcional

Cadeia de caracteres

Não é possível modificar o endereço SIP de um contato. O endereço SIP é atribuído quando o ponto de extremidade do aplicativo é criado.

Type

Opcional

Cadeia de caracteres

Este parâmetro não é usado com este cmdlet.

PassThru

Opcional

SwitchParameter

Incluir este parâmetro fará com que o cmdlet não apenas modifique o objeto de contato, como também retorne o novo objeto como saída.

WhatIf

Opcional

SwitchParameter

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

SwitchParameter

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact. Aceita entrada em pipeline de objetos de ponto de extremidade de aplicativos confiáveis.

Tipos de Retorno

Este cmdlet não retorna um valor. Ele modifica um objeto do tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.

Exemplo

-------------------------- Exemplo 1 ------------------------

Set-CsTrustedApplicationEndpoint -Identity "sip:endpoint1@litwareinc.com" -DisplayName "Endpoint 1"

Esse exemplo modifica o objeto de contato de ponto de extremidade de aplicativo com o endereço SIP endpoint1@litwareinc.com. Observe que o valor da identidade começa com sip: seguido pelo endereço SIP. O parâmetro seguinte, DisplayName, recebe “Endpoint 1”, fazendo com que o nome para exibição do contato seja alterado para esse valor.

-------------------------- Exemplo 2 ------------------------

Get-CsTrustedApplicationEndpoint -Identity "Endpoint 1" | Set-CsTrustedApplicationEndpoint -DisplayNumber "(425)555-1212"

Esse exemplo modifica o número para exibição do aplicativo de ponto de extremidade com nome para exibição igual a Endpoint 1. O comando começa com uma chamada a Get-CsTrustedApplicationEndpoint, com Identidade igual a Endpoint 1. Isso recupera o objeto de contato de ponto de extremidade que possui esse nome para exibição. Esse objeto é então canalizado para o cmdlet Set-CsTrustedApplicationEndpoint, que modifica o DisplayNumber para o valor, que nesse caso é (425)555-1212.