• Articolo

Set-CsTrustedApplication

 

Ultima modifica dell'argomento: 2012-03-26

Consente di modificare le impostazioni di un'applicazione attendibile.

Sintassi

Set-CsTrustedApplication [-Identity <ExternalApplicationIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Port <Int32>] [-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 modificare il numero della porta utilizzata dal servizio esterno che esegue l'applicazione.

Quando si utilizza questo cmdlet per modificare un'applicazione attendibile, si deve fornire un valore per il parametro Identity. Questa Identity è il nome completo qualificato del dominio (FQDN) del pool sul quale è domiciliata l'applicazione seguito da una barra (/) seguito dall'ID dell'applicazione. Ad esempio, TrustPool.litwareinc.com/tapp2, dove TrustPool.litwareinc.com rappresenta il FQDN del pool e tapp2 è l'ID dell'applicazione. Si noti che se si visualizza un'applicazione esistente utilizzando il cmdlet Get-CsTrustedApplication, si vedrà un ID molto più simile al seguente: TrustPool.litwareinc.com/urn:application:tapp2. Si noti il prefisso urn:application: prima del nome dell'applicazione(tapp2). Anche se questo prefisso è parte dell'identità, non è necessario quando si specifica il valore per il parametro Identity.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

ExternalApplicationIdentity

L'identificatore univoco dell'applicazione attendibile da modificare. I valori dell'identità devono essere immessi nel formato <FQDN pool>/<ID applicazione>, dove "FQDN pool" è il nome di dominio completo (FQDN) del pool in cui risiede l'applicazione e "ID applicazione" è il nome dell'applicazione.

Port

Facoltativo

Int32

Il numero della porta sulla quale verrà eseguita l'applicazione.

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

Oggetto Microsoft.Rtc.Management.Xds.DisplayTrustedApplication. Accetta input tramite pipeline da oggetti applicazione attendibile.

Tipi restituiti

Questo cmdlet non restituisce un valore. Consente di modificare un oggetto di tipo Microsoft.Rtc.Management.Xds.DisplayTrustedApplication.

Esempio

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

Set-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2 -Port 6200

Questo esempio consente di modificare la porta per l'applicazione attendibile con valore Identity TrustPool.litwareinc.com/tapp2 nella porta 6200. Questo risultato viene ottenuto passando al cmdlet Set-CsTrustedApplication un parametro Identity TrustPool.litwareinc.com/tapp2. Questo parametro Identity è costituito dal nome del pool in cui si trova l'applicazione seguito dal nome (o ID) dell'applicazione. Viene quindi incluso il parametro Port, a cui viene assegnato il valore 6200, per modificare il valore esistente.