Condividi tramite

  • Articolo

New-CsTrustedApplicationEndpoint

 

Ultima modifica dell'argomento: 2012-03-25

Crea un nuovo contatto endpoint per un'applicazione attendibile.

Sintassi

New-CsTrustedApplicationEndpoint -ApplicationId <String> -TrustedApplicationPoolFqdn <Fqdn> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-PrimaryLanguage <String>] [-SecondaryLanguages <MultiValuedProperty>] [-SipAddress <String>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Un endpoint applicazione attendibile è un oggetto contatto di Active Directory che consente il routing delle chiamate verso un'applicazione attendibile. Questo cmdlet consente di creare un nuovo oggetto contatto endpoint in Servizi di dominio Active Directory per un'applicazione specificata.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet New-CsTrustedApplicationEndpoint in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

ApplicationId

Obbligatorio

Stringa

L'ID dell'applicazione attendibile per cui deve essere creato il contatto endpoint. Deve esistere un'applicazione con questo ID. È possibile includere solo la parte del nome dell'ID dell'applicazione; non è necessario (ma è possibile) includere le informazioni del prefisso. Ad esempio, se l'ID dell'applicazione è urn:application:TrustedApp1, è sufficiente passare la stringa TrustedApp1 a questo parametro.

TrustedApplicationPoolFqdn

Obbligatorio

FQDN

Il nome di dominio completo del pool di applicazioni attendibili associato all'applicazione. Per creare l'endpoint è necessario che l'applicazione sia già associata a questo pool.

SipAddress

Facoltativo

Stringa

Un indirizzo SIP per il nuovo oggetto contatto. Se non si include un valore per questo parametro, viene generato automaticamente un indirizzo SIP nel formato sip:RtcApplication-<GUID>.<dominio>, ad esempio sip:RtcApplication-fbf9e2d1-c6aa-45a3-a045-b92d4ef961b2@litwareinc.com. Il dominio sarà il dominio SIP predefinito.

DisplayName

Facoltativo

Stringa

Il nome visualizzato dell'oggetto contatto endpoint.

DisplayNumber

Facoltativo

Stringa

Il numero di telefono del contatto come sarà visualizzato nella Rubrica.

LineURI

Facoltativo

Stringa

Il numero di telefono del contatto. Deve essere nel formato TEL:<numero>, ad esempio TEL:+14255551212.

PrimaryLanguage

Facoltativo

Int32

La lingua principale utilizzate per l'applicazione attendibile. La lingua deve essere configurata utilizzando un codice di lingua valido, ad esempio en-US (inglese americano), fr-FR (francese), ecc.

SecondaryLanguages

Facoltativo

Int32[]

Una raccolta delle lingue utilizzabili per le applicazioni attendibili. I valori devono essere configurati in un elenco separato da virgole di codici di lingua. Ad esempio, la sintassi riportata di seguito consente di impostare il francese canadese e il francese come lingue secondarie: -SecondaryLanguages "fr-CA","fr-FR".

Tenant

Facoltativo

GUID

L'identificatore univoco globale (GUID) dell'oggetto Questo parametro non è utilizzato per le distribuzioni locali.

PassThru

Facoltativo

Parametro opzionale

Restituisce i risultati di questo comando. Con l'esecuzione del cmdlet viene visualizzato l'oggetto appena creato; se si include questo parametro tale output viene ripetuto, pertanto l'uso del parametro si rivela ridondante.

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

Nessuno.

Tipi restituiti

Consente di creare un oggetto di tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.

Esempio

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

New-CsTrustedApplicationEndpoint -ApplicationId tapp1 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com

Con questo esempio viene creato un endpoint applicazione attendibile per l'applicazione con ID tapp1 residente nel pool TrustPool.litwareinc.com. ApplicationID e TrustedApplicationPoolFqdn sono i soli parametri richiesti per creare un endpoint applicazione attendibile. Tuttavia, è importante ricordare che l'assegnazione dei valori a questi due soli parametri consente di generare un indirizzo SIP per il contatto. Per garantire che l'indirizzo SIP sia univoco, l'indirizzo generato automaticamente contiene un identificatore univoco globale (GUID) ed è simile a quello riportato di seguito: sip:RtcApplication-fbf9e2d1-c6aa-45a3-a045-b92d4ef961b2@litwareinc.com. Se si desidera un indirizzo SIP più leggibile, vedere l'esempio 2.

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

New-CsTrustedApplicationEndpoint -ApplicationId tapp1 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com -SipAddress sip:endpoint1@litwareinc.com

L'esempio 2 è identico all'esempio 1 in quanto crea un endpoint applicazione attendibile per l'applicazione con ID tapp1 nel pool TrustPool.litwareinc.com. A differenza dell'esempio 1, è stato incluso un altro parametro nella creazione dell'endpoint, SipAddress. Invece di lasciare che sia il sistema a generare un indirizzo SIP, è stato specificato l'indirizzo endpoint1@litwareinc.com.