• Articolo

Get-CsExUmContact

 

Ultima modifica dell'argomento: 2012-03-23

Consente di recuperare uno o più oggetti contatto Messaggistica unificata di Exchange ospitati.

Sintassi

Get-CsExUmContact [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LdapFilter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]

Descrizione dettagliata

Microsoft Lync Server 2010 collabora con Messaggistica unificata di Exchange per fornire diverse funzionalità vocali, tra cui Operatore automatico e accesso sottoscrittore. Quando Messaggistica unificata di Exchange è fornito come servizio ospitato (anziché locale), è necessario creare gli oggetti contatto utilizzando Windows PowerShell per applicare le funzionalità Operatore automatico e Accesso sottoscrittore. Questo cmdlet consente di recuperare uno o più di questi contatti.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsExUmContact può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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 "Get-CsExUmContact"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

UserIDParameter

L'identificatore univoco dell'oggetto contatto che si desidera recuperare. Le identità dei contatti possono essere specificate con uno dei quattro formati riportati di seguito: 1) l'indirizzo SIP del contatto; 2) l'UPN (User Principal Name) del contatto; 3) il nome di dominio e il nome di accesso del contatto, nella forma dominio\accesso (ad esempio litwareinc\davidegarghentini); 4) il nome visualizzato in Active Directory per il contatto (ad esempio Team Auto Attendant).

Tipo di dati completi: Microsoft.Rtc.Management.AD.UserIdParameter

Filter

Facoltativo

Stringa

Consente di limitare i dati restituiti applicando un filtro in base ad attributi specifici di Lync Server 2010. Ad esempio, è possibile limitare i dati restituiti ai contatti i cui URI di linea iniziano con "tel:555".

Il parametro Filter utilizza un sottoinsieme della 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.

LdapFilter

Facoltativo

Stringa

Consente di limitare i dati restituiti applicando un filtro in base ad attributi generici di Active Directory (ovvero attributi non specifici di Lync Server).

Il parametro LdapFilter utilizza il linguaggio delle query LDAP per creare i filtri.

Credential

Facoltativo

PSCredential

Consente di eseguire il cmdlet utilizzando credenziali alternative. Può essere necessario se l'account utilizzato per accedere a Windows non dispone dei privilegi necessari richiesti per lavorare con gli oggetti contatto.

Per utilizzare il parametro Credential, è necessario innanzitutto creare un oggetto PSCredential utilizzando il cmdlet Get-Credential.

DomainController

Facoltativo

Fqdn

Consente di eseguire la connessione al controller di dominio specificato per recuperare le informazioni sul contatto. Per la connessione a uno specifico controller di dominio, includere il parametro DomainController seguito dal nome computer (ad esempio atl-mcs-001) o dal suo nome di dominio completo (ad esempio atl-mcs-001.litwareinc.com).

Tipo di dati completi: Microsoft.Rtc.Management.Deploy.Fqdn

OU

Facoltativo

OUIdParameter

Consente di limitare le informazioni recuperate in modo da includere esclusivamente quelle di una specifica unità organizzativa di Active Directory. Vengono restituiti dati dell'unità organizzativa specificata e delle unità organizzative figlio.

Per specificare un'unità organizzativa occorre utilizzare il nome distinto del contenitore, ad esempio OU=ExUmContacts,dc=litwareinc,dc=com.

ResultSize

Facoltativo

Numero intero

Consente di limitare il numero di record restituiti da un comando. Ad esempio, per ottenere solo sette contatti (indipendentemente dal numero di contatti nella foresta), includere il parametro ResultSize e impostarlo su 7. Si noti che non è possibile stabilire a priori quali sette contatti verranno restituiti. Se si imposta ResultSize su 7 ma la foresta contiene solo tre contatti, il comando restituisce tali tre contatti e viene completato senza errori.

La dimensione del risultato può essere impostata su qualsiasi numero intero compreso tra 0 e 2147483647 (compresi). Se l'impostazione è 0 il comando viene eseguito ma non restituisce dati.

Tipo di dati completi: Microsoft.Rtc.Management.ADConnect.Core.Unlimited

Tipi di input

Stringa. Accetta una stringa inviata tramite pipeline che rappresenta l'identità dell'oggetto contatto Messaggistica unificata di Exchange.

Tipi restituiti

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

Esempio

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

Get-CsExUmContact

In questo esempio vengono recuperati tutti i contatti Messaggistica unificata di Exchange definiti in una distribuzione di Lync Server 2010.

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

Get-CsExUmContact -Identity sip:exum1@fabrikam.com

Con questo esempio viene recuperato il contatto Messaggistica unificata di Exchange con indirizzo SIP sip:exum1@fabrikam.com

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

Get-CsExUmContact -Filter {Enabled -eq $False}

In questo esempio viene utilizzato il parametro Filter per recuperare tutti i contatti Messaggistica unificata di Exchange che non sono abilitati per Lync Server 2010. Per ottenere questo risultato, viene applicato un filtro alla proprietà Enabled per verificare se il suo valore è uguale a (-eq) False ($False). I contatti restituiti da questo comando non saranno utilizzabili.

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

Get-CsExUmContact -Filter {LineURI -like "tel:555*"}

Con questo comando viene applicato un filtro basato sulla proprietà LineURI per recuperare tutti i contatti Messaggistica unificata di Exchange il cui LineURI inizia con 555. In altre parole, vengono recuperati tutti i contatti che iniziano con 555.

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

Get-CsExUmContact -OU "OU=ExUmContacts,DC=Vdomain,DC=com"

Con il comando in questo esempio viene utilizzato il parametro OU per recuperare tutti i contatti Messaggistica unificata di Exchange nell'unità organizzativa di Active Directory OU=ExUmContacts,DC=Vdomain,DC=com.