Get-CsAdContact
Ultima modifica dell'argomento: 2012-03-23
In una topologia a più foreste restituisce informazioni sugli account utente di foreste diverse dalla propria. Si tratta di utenti che sono stati replicati come oggetti contatto da Microsoft Forefront Identity Manager 2010 o da una versione precedente del prodotto. Get-CsAdContact restituisce tutti gli utenti che hanno configurato un valore per l'attributo msRTCSIP-OriginatorSid.
Sintassi
Get-CsAdContact [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LDAPFilter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]
Descrizione dettagliata
In una topologia a più foreste, gli utenti delle altre foreste vengono presentati come contatti. Tali contatti sono diversi dai contatti Active Directory; se si utilizza Utenti e computer di Active Directory per creare un nuovo contatto, l'utente in questione non viene restituito chiamando il cmdlet Get-CsAdContact. Al contrario, Get-CsAdContact consente di restituire solo le informazioni sugli utenti di foreste diverse dalla propria. Se non si dispone di una topologia a più foreste, non è necessario chiamare Get-CsAdContact.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsAdContact 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-CsAdContact"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
Parametro ID utente |
Indica l'identità del contatto da restituire. Le identità dei contatti possono essere specificate con uno dei tre formati seguenti: 1) l'indirizzo SIP del contatto, 2) il nome distinto Active Directory del contatto e 3) il nome visualizzato Active Directory del contatto, ad esempio Davide Garghentini. È possibile utilizzare il carattere jolly asterisco (*) quando si utilizza il nome visualizzato come identità del contatto. L'identità "* Smith" ad esempio restituisce tutti i contatti il cui nome visualizzato termina con il valore stringa "Smith". |
Credential |
Facoltativo |
Oggetto PSCredential |
Consente di eseguire il cmdlet Get-CsAdContact 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 creare per prima cosa un oggetto PSCredential utilizzando il cmdlet Get-Credential. Per informazioni dettagliate, vedere l'argomento della Guida Get-Credential. |
DomainController |
Facoltativo |
Stringa |
Consente la connessione al controller di dominio specificato per recuperare le informazioni di contatto. Per connettersi a un controller di dominio particolare, includere il parametro DomainController, seguito dal nome di dominio completo, ad esempio atl-cs-001.litwareinc.com. |
Filter |
Facoltativo |
Stringa |
Consente di limitare i dati restituiti applicando un filtro in base ad attributi specifici per Microsoft Lync Server 2010. Il parametro Filter utilizza la stessa sintassi di filtro Windows PowerShell impiegata dal cmdlet Where-Object. Un filtro che restituisce solamente i contatti con indirizzo SIP che termina con "fabrikam.com" ad esempio potrebbe essere simile al seguente: {SipAddress -like "*@fabrikam.com"}, dove SipAddress rappresenta l'attributo Active Directory, -like rappresenta l'operatore di confronto e "*@fabrikam.com" rappresenta il valore di filtro. |
LdapFilter |
Facoltativo |
Stringa |
Consente di limitare i dati restituiti applicando un filtro in base ad attributi Active Directory generici. Ad esempio, è possibile limitare i dati restituiti ai contatti che lavorano in un reparto specifico o ai contatti che possiedono un manager o un titolo professionale specificato. Il parametro LdapFilter utilizza il linguaggio di query LDAP per la creazione di filtri. Un filtro che restituisce il contatto con numero di telefono 1-425-555-1298 ad esempio potrebbe essere simile al seguente: "telephoneNumber=1-425-555-1298", dove "telephoneNumber" rappresenta l'attributo Active Directory, "=" rappresenta l'operatore di confronto (uguale a) e "1-425-555-1298" rappresenta il valore di filtro. |
OU |
Facoltativo |
Nome distinto |
Consente di limitare le informazioni recuperate da una specifica unità organizzativa o contenitore di Active Directory. Questo parametro restituisce i dati dell'unità organizzativa specificata e delle unità organizzative figlio. Ad esempio, se l'unità organizzativa Finance dispone di due unità organizzative figlio: AccountsPayable e AccountsReceivable, verranno restituiti i contatti di ciascuna di queste unità organizzative. Per specificare un'unità organizzativa occorre utilizzare il nome distinto del contenitore, ad esempio: OU=Finance,dc=litwareinc,dc=com. |
ResultSize |
Facoltativo |
Numero intero |
Consente di limitare il numero di record restituiti dal cmdlet. Per restituire ad esempio sette contatti (indipendentemente dal numero di contatti presenti nella foresta), includere il parametro ResultSize e impostarne il valore su 7. Non è possibile stabilire quali dei sette utenti verranno restituiti. 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. Se si imposta ResultSize su 7 ma nella foresta sono contenuti solo tre contatti, il comando restituirà i tre contatti e quindi verrà completato senza errori. |
Tipi di input
Stringa. Get-CsAdContact accetta un valore stringa da pipeline che rappresenta l'identità di un account utente.
Tipi restituiti
Get-CsAdContact restituisce istanze dell'oggetto Microsoft.Rtc.Management.ADConnect.Schema.ADContact.
Esempio
-------------------------- Esempio 1 ------------------------
Get-CsAdContact
Il comando mostrato nell'esempio 1 restituisce una raccolta dei contatti di tutte le altre foreste rilevate in Servizi di dominio Active Directory. Se si chiama Get-CsAdContact senza alcun parametro, vengono restituiti tutti i valori proprietà di tutti i contatti Active Directory.
-------------------------- Esempio 2 ------------------------
Get-CsAdContact | Select-Object DisplayName, SipAddress
Anche nell'esempio 2 viene restituita una raccolta di tutti i contatti Active Directory. In questo caso, tuttavia, la raccolta viene inviata tramite pipe al cmdlet Select-Object, che consente di specificare gli unici due attributi che verranno visualizzati sullo schermo: DisplayName e SipAddress.
-------------------------- Esempio 3 ------------------------
Get-CsAdContact -Identity "Ken Myer"
Il comando precedente restituisce le informazioni su un unico contatto Active Directory: il contatto con valore Identity "Davide Garghentini".
-------------------------- Esempio 4 ------------------------
Get-CsAdContact -LdapFilter "Organization=Fabrikam"
Nell'esempio 4 il comando restituisce tutti i contatti Active Directory che lavorano per Fabrikam. A tale scopo, viene chiamato Get-CsAdContact con il parametro LdapFilter. In questo esempio i dati restituiti si limitano ai contatti con attributo Organization impostato su "Fabrikam".
-------------------------- Esempio 5 ------------------------
$x = Get-Credential -Credential "litwareinc\administrator"
Get-CsAdContact -Credential $x
Con i due comandi mostrati nell'esempio 5 viene illustrato l'utilizzo del parametro Credential, che consente di eseguire Get-CsAdContact utilizzando credenziali alternative. Nel primo comando viene chiamato il cmdlet Get-Credential per creare un oggetto PSCredential per l'account litwareinc\administrator. Questo comando visualizza una finestra di dialogo di richiesta credenziali per l'utente litwareinc\administrator. Dopo aver specificato la password dell'account, le credenziali vengono archiviate nella variabile $x. Con il secondo comando viene chiamato Get-CsAdContact insieme al parametro Credential. Il valore di parametro $x indica che Get-CsAdContact deve essere eseguito con l'account litwareinc\administrator.