Condividi tramite

  • Articolo

Get-CsTrustedApplicationEndpoint

 

Ultima modifica dell'argomento: 2012-03-23

Recupera le informazioni su uno o più endpoint applicazione attendibile.

Sintassi

Get-CsTrustedApplicationEndpoint [-Identity <UserIdParameter>] [-ApplicationId <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>] [-TrustedApplicationPoolFqdn <String>]

Descrizione dettagliata

L'endpoint applicazione attendibile è un oggetto contatto di Active Directory che consente il routing delle chiamate verso un'applicazione attendibile. Questo cmdlet recupera uno o più oggetti contatto dell'endpoint esistenti in Servizi di dominio Active Directory.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi seguenti sono autorizzati a eseguire il cmdlet Get-CsTrustedApplicationEndpoint in locale: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Per restituire un elenco di tutti i ruoli del controllo di accesso basato sui ruoli (RBAC) ai quali è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati creati dall'utente), eseguire il comando seguente dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

UserIDParameter

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

Filter

Facoltativo

Stringa

Consente di limitare i dati restituiti applicando un filtro in base ad attributi specifici per Microsoft Lync Server 2010. Ad esempio, è possibile limitare i dati restituiti ai contatti, i cui nomi visualizzati o indirizzi SIP corrispondono a un determinato modello di caratteri jolly.

Il parametro Filter utilizza la stessa sintassi di filtro Windows PowerShell impiegata dal cmdlet Where-Object. Ad esempio, un filtro che restituisce solamente i contatti abilitati per VoIP aziendale potrebbe essere simile al seguente: {EnterpriseVoiceEnabled -eq $True}, dove EnterpriseVoiceEnabled rappresenta l'attributo di Active Directory, -eq rappresenta l'operatore di confronto (uguale a) e $True (una variabile predefinita di Windows PowerShell) rappresenta il valore del filtro.

ApplicationId

Facoltativo

Stringa

L'ID applicazione dell'applicazione attendibile per l'endpoint che si desidera recuperare.

Credential

Facoltativo

PSCredential

Le credenziali alternative da utilizzare per recuperare l'endpoint. Per recuperare un oggetto PSCredential è possibile chiamare il cmdlet Get-Credential.

DomainController

Facoltativo

FQDN

Consente di specificare un controller di dominio. Se non è specificato alcun controller di dominio, verrà utilizzato il primo disponibile.

OU

Facoltativo

OUIdParameter

Il parametro OU in cui risiede l'endpoint.

ResultSize

Facoltativo

Illimitato

Il numero massimo di record endpoint da recuperare.

TrustedApplicationPoolFqdn

Facoltativo

Stringa

Il nome di dominio completo (FQDN) del pool di applicazioni attendibili associato all'applicazione dell'endpoint che si desidera recuperare.

Tipi di input

Stringa. Accetta un valore stringa inviato tramite pipe che rappresenta l'identità di un account utente.

Tipi restituiti

Restituisce un oggetto di tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.

Esempio

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

Get-CsTrustedApplicationEndpoint

In questo esempio vengono recuperate le informazioni su tutti gli endpoint applicazione attendibile definiti all'interno della distribuzione di Lync Server 2010.

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

Get-CsTrustedApplicationEndpoint -Identity "sip:endpoint1@litwareinc.com"

Nell'esempio 2 vengono recuperate le informazioni sul contatto endpoint applicazione con indirizzo SIP endpoint1@litwareinc.com. Il prefisso sip: è obbligatorio quando l'indirizzo SIP viene utilizzato come parametro Identity.

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

Get-CsTrustedApplicationEndpoint -Filter {DisplayName -like "*endpoint*"}

Nell'esempio 3 vengono recuperati tutti gli endpoint applicazione attendibile che hanno la stringa "endpoint" in una posizione qualsiasi all'interno del nome visualizzato. A tale scopo, il comando utilizza il parametro Filter. Il valore del parametro applica un filtro per trovare oggetti endpoint che hanno un nome visualizzato (DisplayName) contenente (-like) la stringa endpoint (*endpoint* - i caratteri jolly indicano che la stringa endpoint può essere preceduta o seguita da qualsiasi carattere, ovvero l'endpoint può trovarsi in una posizione qualsiasi all'interno del nome visualizzato).

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

Get-CsTrustedApplicationEndpoint -ApplicationId tapp2 | Select-Object SipAddress, DisplayName, OwnerUrn

Nell'esempio 4 vengono restituiti tutti gli endpoint applicazione attendibile associati all'applicazione tapp2. A tale scopo, viene passato ID tapp2 al parametro ApplicationId. Non è stato fornito un nome di dominio completo (FQDN) del pool, pertanto se esiste un'applicazione con ID tapp2 in più di un pool, verranno recuperati gli endpoint per tutte le applicazioni. La parte successiva del comando invia tramite pipe l'oggetto o gli oggetti restituiti al cmdlet Select-Object, che visualizza solamente le proprietà SipAddress, DisplayName e OwnerUrn di tali oggetti.