Compartir a través de

  • Artículo

Set-CsTrustedApplicationEndpoint

 

Última modificación del tema: 2012-03-25

Modifica un contacto de extremo existente para una aplicación de confianza.

Sintaxis

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

Descripción detallada

Un extremo de una aplicación de confianza es un objeto de contacto de Active Directory que permite el enrutamiento de llamadas a una aplicación de confianza. Este cmdlet modifica un objeto de contacto de extremo existente en Active Directory Domain Services (AD DS).

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsTrustedApplicationEndpoint localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

UserIdParameter

La Identidad (el nombre distintivo) o la dirección SIP del extremo de la aplicación que se debe modificar.

DisplayName

Opcional

Cadena de caracteres

El nombre para mostrar del objeto de contacto del extremo.

DisplayNumber

Opcional

Cadena de caracteres

El número de teléfono del contacto tal como aparecerá en la Libreta de direcciones.

Enabled

Opcional

Booleano

Determina si el contacto está habilitado para Lync Server 2010.

Valor predeterminado: True

EnabledForFederation

Opcional

Booleano

Determina si los usuarios federados tienen acceso a este contacto.

Valor predeterminado: False

EnterpriseVoiceEnabled

Opcional

Booleano

Determina si el contacto está habilitado para Enterprise Voice.

Valor predeterminado: True

LineURI

Opcional

Cadena de caracteres

El número de teléfono del contacto. Debe estar en formato TEL:<número>, por ejemplo, TEL:+14255551212.

PrimaryLanguage

Opcional

Int32

El idioma principal que se usa para la aplicación de confianza. El idioma debe configurarse con uno de los códigos de idioma válidos, como en-US (inglés de EE. UU.), fr-FR (francés), etc.

SecondaryLanguages

Opcional

MultiValuedProperty

Colección de idiomas que además se puede usar para aplicaciones de confianza. Los valores deben configurarse como lista de valores separados por comas de los códigos de idioma. Por ejemplo, la siguiente sintaxis define francés canadiense y francés como idiomas secundarios: -SecondaryLanguages "fr-CA","fr-FR".

SipAddress

Opcional

Cadena de caracteres

No puede modificar la dirección SIP de un contacto. La dirección SIP se asigna cuando se crea el extremo de la aplicación.

Type

Opcional

Cadena de caracteres

Este parámetro no se usa con este cmdlet.

PassThru

Opcional

Parámetro modificador

Si se incluye este parámetro, hará que el cmdlet no solo modifique el objeto de contacto sino que devuelva un nuevo objeto como resultado.

WhatIf

Opcional

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Opcional

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact. Acepta entradas canalizadas de objetos de extremo de aplicaciones de confianza.

Tipos de valores devueltos

Este cmdlet no devuelve un valor. Modifica un objeto de tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

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

Este ejemplo modifica el objeto de contacto de extremo de la aplicación con la dirección SIP endpoint1@litwareinc.com. Observe que el valor Identity comienza con la cadena sip: seguido de la dirección SIP. El siguiente parámetro, DisplayName, tiene el valor de “Endpoint 1”, que cambia el nombre para mostrar del contacto a ese valor.

-------------------------- Ejemplo 2 --------------------------

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

Este ejemplo modifica el número para mostrar de la aplicación de extremo con el nombre para mostrar Endpoint 1. El comando comienza con una llamada a Get-CsTrustedApplicationEndpoint con una Identidad de Endpoint 1. Esto recupera el objeto de contacto de extremo con ese nombre para mostrar. Este objeto, luego, se transfiere al cmdlet Set-CsTrustedApplicationEndpoint, que modifica DisplayNumber al valor, en este caso, (425)555-1212.