Get-CsApplicationEndpoint
Ultima modifica dell'argomento: 2012-03-23
Consente di recuperare gli endpoint per il Servizio applicazione.
Sintassi
Get-CsApplicationEndpoint [-Identity <UserIdParameter>] [-ApplicationId <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-PoolFqdn <String>] [-ResultSize <Unlimited>]
Descrizione dettagliata
Questo cmdlet consente di recuperare uno o più contatti dell'applicazione da Servizi di dominio Active Directory. Questi oggetti sono archiviati in Active Directory, nel contenitore Application Contacts del servizio RTC.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Get-CsApplicationEndpoint in locale: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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 "Get-CsApplicationEndpoint"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
UserIDParameter |
L'identità, l'indirizzo SIP o il nome visualizzato dell'endpoint applicazione da recuperare. L'identità è costituita dal nome distinto dell'endpoint. Tipicamente contiene un GUID come parte del CN, ad esempio: CN={8811fefe-e0bb-4fab-ae39-7aaeddd423dc},CN=Application Contacts,CN=RTC Service,CN=Services,CN=Configuration,DC=Vdomain,DC=com. |
ApplicationId |
Facoltativo |
Stringa |
L'ID applicazione dell'endpoint applicazione da recuperare. L'ID dell'applicazione è il valore della proprietà OwnerUrn dell'endpoint. Ad esempio, se la proprietà OwnerUrn assume il valore urn:application:Caa, l'ID dell'applicazione è urn:application:Caa. Tuttavia, è possibile immettere solo il suffisso, in questo caso Caa, per recuperare l'endpoint. Ad esempio: -ApplicationId Caa |
Credential |
Facoltativo |
PSCredential |
Credenziali alternative con cui eseguire l'operazione Get. Per recuperare un oggetto PSCredential è possibile chiamare il cmdlet Get-Credential di Windows PowerShell. |
DomainController |
Facoltativo |
FQDN |
Consente di specificare un controller di dominio. Se non è specificato alcun controller di dominio, verrà utilizzato il primo disponibile. |
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. |
OU |
Facoltativo |
OUIdParameter |
L'unità organizzativa in cui risiede l'endpoint. |
PoolFqdn |
Facoltativo |
Stringa |
Il nome di dominio completo del pool su cui risiede l'endpoint applicazione. |
ResultSize |
Facoltativo |
Illimitato |
Il numero massimo di record endpoint da recuperare. |
Tipi di input
Stringa. Accetta un valore stringa da pipeline che rappresenta l'identità dell'endpoint applicazione.
Tipi restituiti
Recupera un oggetto di tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.
Esempio
-------------------------- Esempio 1 --------------------------
Get-CsApplicationEndpoint
Con questo esempio vengono recuperate le informazioni su tutti gli endpoint applicazione definiti nella distribuzione di Lync Server 2010.
-------------------------- Esempio 2 --------------------------
Get-CsApplicationEndpoint -Identity "Call Park Service Contact"
Con l'esempio 2 vengono recuperate le informazioni sul contatto endpoint applicazione con nome visualizzato "Call Park Service".
-------------------------- Esempio 3 --------------------------
Get-CsApplicationEndpoint -Filter {DisplayName -like "*endpoint*"}
Con l'esempio 3 vengono recuperati tutti gli endpoint applicazione contenenti la stringa "endpoint" nel loro nome visualizzato. A tal fine, 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-CsApplicationEndpoint -ApplicationId tapp2 | Select-Object Identity, SipAddress, DisplayName, OwnerUrn
Con l'esempio 4 vengono restituiti tutti gli endpoint applicazione associati all'applicazione urn:application: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 solo le proprietà Identity, SipAddress, DisplayName e OwnerUrn di questi oggetti.