Condividi tramite

  • Articolo

Set-CsTrustedApplicationEndpoint

 

Ultima modifica dell'argomento: 2012-03-25

Consente di modificare un contatto endpoint per un'applicazione attendibile.

Sintassi

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

Descrizione dettagliata

L'endpoint di un'applicazione attendibile è un oggetto contatto Active Directory che consente il routing delle chiamate verso un'applicazione attendibile. Questo cmdlet modifica un oggetto contatto endpoint in Servizi di dominio Active Directory.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-CsTrustedApplicationEndpoint può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Parametro User ID

L'identità (il nome distinto) o l'indirizzo SIP dell'endpoint dell'applicazione da modificare.

DisplayName

Facoltativo

Stringa

Il nome visualizzato dell'oggetto contatto endpoint.

DisplayNumber

Facoltativo

Stringa

Il numero telefonico del contatto come apparirà nella Rubrica.

Enabled

Facoltativo

Booleano

Indica se il contatto è abilitato per Lync Server 2010.

Valore predefinito: True

EnabledForFederation

Facoltativo

Booleano

Indica se gli utenti federati hanno accesso a questo contatto.

Valore predefinito: False

EnterpriseVoiceEnabled

Facoltativo

Booleano

Indica se il contatto è abilitato per VoIP aziendale.

Valore predefinito: True

LineURI

Facoltativo

Stringa

Il numero telefonico del contatto. Deve avere il formato TEL:<numero>, ad esempio TEL:+14255551212.

PrimaryLanguage

Facoltativo

Int32

La lingua primaria utilizzata dall'applicazione attendibile. La lingua deve essere configurata utilizzando un valido codice lingua, quali en-US (Inglese U.S.), fr-FR (Francese), ecc.

SecondaryLanguages

Facoltativo

MultiValuedProperty

Una raccolta di lingue che può essere utilizzata per applicazioni attendibili. I valori devono essere configurati come elenco di codici lingua delimitati da virgole. Ad esempio, la seguente sintassi imposta Francese canadese e Francese come lingua secondaria: -SecondaryLanguages "fr-CA","fr-FR".

SipAddress

Facoltativo

Stringa

Non è possibile modificare l'indirizzo SIP di un contatto. L'indirizzo SIP viene assegnato quando viene creato l'endpoint dell'applicazione.

Type

Facoltativo

Stringa

Questo parametro non è utilizzato con questo cmdlet.

PassThru

Facoltativo

Parametro opzionale

Se si include questo parametro, il cmdlet non modificherà solo l'oggetto contatto, ma restituirà il nuovo oggetto come risultato.

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Facoltativo

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Oggetto Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact. Accetta input tramite pipeline di oggetti endpoint dell'applicazione attendibile.

Tipi restituiti

Questo cmdlet non restituisce un valore. Consente di modificare un oggetto di tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.

Esempio

-------------------------- Esempio 1 ------------------------

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

In questo esempio, viene modificato l'oggetto contatto endpoint con l'indirizzo SIP endpoint1@litwareinc.com. Si noti che il valore Identity inizia con la stringa sip: seguita dall'indirizzo SIP. Il parametro successivo, DisplayName, ha come valore "Endpoint 1" che modifica con quel valore il nome visualizzato del contatto.

-------------------------- Esempio 2 ------------------------

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

In questo esempio, viene modificato il numero visualizzato dell'endpoint dell'applicazione con nome visualizzato Endpoint 1. Il comando inizia utilizzando Get-CsTrustedApplicationEndpoint con l'identità Endpoint 1. In questo modo, si recupera l'oggetto contatto endpoint con quel nome visualizzato. Questo oggetto viene quindi inviato tramite pipe al cmdlet Set-CsTrustedApplicationEndpoint che cambia DisplayNumber con il valore, in questo caso, (425)555-1212.