• Articolo

New-CsTrustedApplication

 

Ultima modifica dell'argomento: 2012-03-26

Consente di aggiungere un'applicazione attendibile a un pool.

Sintassi

New-CsTrustedApplication -ApplicationId <String> -Port <Int32> -TrustedApplicationPoolFqdn <String> [-Confirm [<SwitchParameter>]] [-EnableTcp <SwitchParameter>] [-Force <SwitchParameter>] [-LegacyApplicationName <String>] [-WhatIf [<SwitchParameter>]]

New-CsTrustedApplication [-Identity <ExternalApplicationIdentity>] -Port <Int32> [-Confirm [<SwitchParameter>]] [-EnableTcp <SwitchParameter>] [-Force <SwitchParameter>] [-LegacyApplicationName <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Un'applicazione attendibile è un'applicazione sviluppata da terzi alla quale è stato assegnato lo stato di attendibile per essere eseguita come parte di Microsoft Lync Server 2010, ma che non è parte integrante del prodotto. Questo cmdlet consente di aggiungere un'applicazione attendibile a un pool di applicazioni attendibili e di assegnare una porta al servizio esterno che esegue l'applicazione.

Le applicazioni attendibili devono essere associate ai GRUU (Globally Routable User Agent URI) sia del servizio sia del computer. Questo cmdlet crea automaticamente questi valori in base ai computer e servizi associati al pool che ospita l'applicazione.

Quando viene utilizzato questo cmdlet per creare un'applicazione affidabile, è necessario fornire il valori del parametro Identity o dei parametri ApplicationID e TrustedApplicationPoolFqdn. L'identità è data dal valore del parametro TrustedApplicationPoolFqdn seguito da una barra (/) e quindi dal valore del parametro ApplicationID. Ad esempio, TrustPool.litwareinc.com/tapp2, dove TrustPool.litwareinc.com è TrustedApplicationPoolFqdn e tapp2 è ApplicationID.

Si noti che quando viene immesso un ID applicazione, come parte del parametro Identity o ApplicationID, occorre immettere solo il nome dell'applicazione. Tuttavia, all'ID applicazione completo verrà automaticamente aggiunto il prefisso urn:application:. Ad esempio, se viene immesso il valore tapp2 per ApplicationID, quell'ID verrà memorizzato nel formato urn:application:tapp2. Allo stesso modo, se viene immessa l'identità TrustPool.litwareinc.com/tapp2, essa verrà memorizzata nel sistema nel formato TrustPool.litwareinc.com/urn:application:tapp2.

Se viene specificato il valore del parametro Port tramite questo cmdlet, il cmdlet non apre la porta. È necessario aprire la porta in Windows Firewall e in eventuali firewall aziendali affinché l'applicazione attendibile possa entrare in contatto con le reti esterne al firewall.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet New-CsTrustedApplication 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 "New-CsTrustedApplication\b"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

ExternalApplicationIdentity

Identificatore univoco dell'applicazione attendibile nel pool. I valori di Identity devono essere immessi nel formato <pool FQDN>/<application ID>, dove pool FQDN è il nome di dominio completo (FQDN) del pool nel quale risiede l'applicazione e application ID è il nome dell'applicazione. L'ID applicazione deve essere univoco per un determinato pool.

Se si specifica un valore per Identity, non è possibile specificare valori anche per i parametri ApplicationId o TrustedApplicationPoolFqdn.

ApplicationId

Obbligatorio

Stringa

Nome dell'applicazione. Questo nome deve essere una stinga univoca nell'ambito del pool specificato nel parametro TrustedApplicationPoolFqdn. La stringa non può contenere spazi. Se viene fornito un valore per il parametro ApplicationId, è necessario specificare un valore anche per il parametro TrustedApplicationPoolFqdn. Non è possibile specificare un valore per ApplicationId e un valore per Identity.

Port

Obbligatorio

Int32

Numero della porta sulla quale verrà eseguita l'applicazione. La porta deve essere univoca in un determinato pool. In altre parole, nel pool specificato non possono essere definite altre applicazioni che utilizzano questa stessa porta.

TrustedApplicationPoolFqdn

Obbligatorio

Stringa

Nome FQDN del pool di applicazioni attendibili nel quale risiederà l'applicazione. Se viene fornito un valore per il parametro TrustedApplicationPoolFqdn, occorre fornire un valore anche per il parametro ApplicationId, ma non per il parametro Identity.

EnableTcp

Facoltativo

Parametro opzionale

Consente di specificare che l'applicazione attendibile utilizza il protocollo TCP (Transmission Control Protocol). Utilizzare questo parametro solo l'applicazione attendibile non è un'applicazione Microsoft Unified Communications Managed API (UCMA). Questo perché le applicazioni UCMA supportano solo il protocollo MTLS (Mutual Transport Layer Security). Se non viene specificato il parametro Force con il parametro EnableTcp, viene visualizzato un messaggio di richiesta di conferma prima che l'applicazione attendibile venga creata.

LegacyApplicationName

Facoltativo

Stringa

Utilizzare questo parametro solamente se si sta eseguendo la migrazione dell'applicazione da una distribuzione Microsoft Office Communications Server 2007 R2. Affinché queste due distribuzioni possano coesistere, questo valore deve essere uguale a quello del tipo GRUU della versione Office Communications Server 2007 R2 dell'applicazione.

Si noti che nella maggior parte dei casi, è sufficiente impostare il parametro ApplicationID su un valore uguale a quello del tipo GRUU perché le applicazioni possano coesistere. Tuttavia, se il tipo GRUU dell'applicazione Office Communications Server 2007 R2 contiene dei caratteri che non sono validi in ApplicationID, è necessario specificare quel valore nel parametro LegacyApplicationName.

Se non si specifica un valore per questo parametro, verrà automaticamente inserito il valore di ApplicationID senza il prefisso urn:application:.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione delle richieste di conferma che altrimenti verrebbero visualizzate prima che vengano apportate le modifiche.

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.Xds.DisplayTrustedApplication.

Esempio

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

New-CsTrustedApplication -ApplicationId tapp1 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com -Port 6000

Questo esempio consente di creare un'applicazione attendibile con Application ID tapp1. Viene utilizzato il parametro TrustedApplicationPoolFqdn per specificare il pool di appartenenza dell'applicazione; in questo caso si tratta del pool con FQDN TrustPool.litwareinc.com. Inoltre, occorre specificare una porta per l'applicazione; in questo esempio viene usata la porta 6000. Si noti che l'esecuzione di questo cmdlet con i valori specificati per i parametri ApplicationId e TrustedApplicationPoolFqdn comporta la creazione automatica di un'identità che potrà essere utilizzata successivamente per recuperare, modificare o rimuovere questa applicazione.

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

New-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2 -Port 6100

In questo esempio viene creata un'applicazione attendibile con Identity TrustPool.litwareinc.com/tapp2 sulla porta (Port) 6100. Si noti il formato del valore di Identity. Questo valore deve essere nel formato <trusted pool FQDN>/<Application ID>.