• Articolo

Get-CsTrustedApplication

 

Ultima modifica dell'argomento: 2012-03-23

Recupera le impostazioni per un'applicazione attendibile.

Sintassi

Get-CsTrustedApplication [-Identity <ExternalApplicationIdentity>]

Get-CsTrustedApplication [-Filter <String>]

Get-CsTrustedApplication [-ApplicationId <String>] [-TrustedApplicationPoolFqdn <String>]

Descrizione dettagliata

Un'applicazione attendibile è un'applicazione sviluppata da terzi cui viene assegnato lo stato di attendibile per essere eseguita come parte di Microsoft Lync Server 2010, sebbene non sia una parte integrata del prodotto. Il cmdlet consente di recuperare le impostazioni di Globally Routable User Agent URI (GRUU) e della porta per una o più applicazioni attendibili.

Quando si utilizza questo cmdlet per recuperare una singola applicazione attendibile, è necessario fornire un valore per il parametro Identity. Il valore Identity è il nome di dominio completo (FQDN) del pool in cui l'applicazione è disponibile seguito da una barra (/) e dall'ID dell'applicazione. Ad esempio, TrustPool.litwareinc.com/tapp2, in cui TrustPool.litwareinc.com è il nome di dominio completo del pool e tapp2 è l'ID dell'applicazione. Se si recupera un'applicazione richiamando questo cmdlet, verrà visualizzato un ID simile al seguente: TrustPool.litwareinc.com/urn:application:tapp2. Si noti il prefisso urn:application: prima del nome dell'applicazione (tapp2). Tale prefisso è parte dell'identità ma non è richiesto quando si specifica il valore del parametro Identity.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsTrustedApplication i membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsTrustedApplication\b"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

ExternalApplicationIdentity

L'identificatore univoco dell'applicazione attendibile che si desidera recuperare. I valori Identity devono essere immessi nel formato <FQDN pool>/<ID applicazione>, dove FQDN pool è il nome di dominio completo del pool in cui risiede l'applicazione e ID applicazione è il nome dell'applicazione. Se si specifica un valore per Identity, non è possibile specificare ApplicationID o TrustedApplicationPoolFqdn.

Filter

Facoltativo

Stringa

Una stringa con caratteri jolly che consente di recuperare le applicazioni attendibili in base ai valori Identity corrispondenti alla stringa con caratteri jolly fornita. Le identità sono costituite da un nome di dominio completo del pool dell'applicazione attendibile seguito da una barra (/) e dall'ID dell'applicazione attendibile. Il valore Filter corrisponderà a qualsiasi parte dell'identità, del nome di dominio completo o dell'ID dell'applicazione.

ApplicationId

Facoltativo

Stringa

Il nome dell'applicazione. Può eventualmente, ma non necessariamente, includere il prefisso dell'ID dell'applicazione. I valori ApplicationId urn:application:tapp1 e tapp1 ad esempio restituiranno entrambi la stessa applicazione. Se si fornisce un valore per ApplicationId, non è possibile fornire un valore per il parametro Identity. Tuttavia, è necessario fornire un valore per il parametro TrustedApplicationPoolFqdn.

TrustedApplicationPoolFqdn

Facoltativo

Stringa

Il nome di dominio completo del pool dell'applicazione attendibile in cui l'applicazione risiede. Se si fornisce un valore per TrustedApplicationPoolFqdn, non è possibile fornire un valore per il parametro Identity. Tuttavia, è necessario fornire un valore per il parametro ApplicationID.

Tipi di input

Nessuno.

Tipi restituiti

Consente di restituire un oggetto di tipo Microsoft.Rtc.Management.Xds.DisplayTrustedApplication.

Esempio

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

Get-CsTrustedApplication

Con questo esempio vengono recuperate le informazioni relative a tutte le applicazioni attendibili definite all'interno della distribuzione di Lync Server 2010.

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

Get-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2

Nell'esempio 2 viene recuperata l'applicazione attendibile con Identity TrustPool.litwareinc.com/urn:application:tapp2. Si noti che è possibile omettere il prefisso urn:application: in quanto Get-CsTrustedApplication lo aggiunge automaticamente e recupera l'applicazione corretta.

-------------------------- Esempio 3 ------------------------

Get-CsTrustedApplication -Filter *trust*

Nell'esempio 3 vengono recuperate tutte le applicazioni attendibili con identità che corrispondono alla stringa con caratteri jolly specificata come valore Filter. In tal caso, con un valore Filter di *trust*, il comando consente di recuperare tutte le applicazioni attendibili con la stringa "trust" all'interno del parametro Identity. La stringa può essere contenuta in qualsiasi parte del parametro Identity, del nome di dominio completo del pool o dell'ID dell'applicazione. Pertanto, questo comando consente di recuperare le applicazioni attendibili con identità quali TrustedPool.litwareinc.com/urn:application:application1, Pool1.litwareinc.com/urn:application:trustedapp e Pool1.litwareinc.com/urn:application:trust.

-------------------------- Esempio 4 ------------------------

Get-CsTrustedApplication -ApplicationId tapp2 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com

Nell'esempio 4 vengono restituiti gli stessi risultati dell'esempio 2 (in cui era stato specificato soltanto il parametro Identity). L'unica differenza tra i due esempi è rappresentata dal fatto che nell'esempio 2 viene recuperata l'applicazione attendibile in base al parametro Identity che è costituito dal nome di dominio completo del pool attendibile seguito dall'ID dell'applicazione. In questo esempio, invece, l'ID dell'applicazione e il nome di dominio completo del pool attendibile vengono immessi come valori di due parametri diversi: ApplicationId e TrustedApplicationPoolFqdn.

-------------------------- Esempio 5 ------------------------

Get-CsTrustedApplication | Where-Object {$_.TrustedApplicationPoolFqdn -eq "TrustPool.litwareinc.com"}

Nell'esempio 5 vengono recuperate le applicazioni attendibili nel pool TrustPool.litwareinc.com. Nell'esempio viene innanzitutto richiamato il cmdlet Get-CsTrustedApplication che consente di restituire una raccolta di tutte le applicazioni attendibili definite all'interno della distribuzione di Lync Server. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, grazie al quale la raccolta viene esaminata elemento per elemento in modo da trovare gli elementi il cui valore della proprietà TrustedApplicationPoolFqdn è uguale a (-eq) TrustPool.litwareinc.com.