Get-CsUserPoolInfo
Ultima modifica dell'argomento: 2012-03-23
Restituisce le informazioni relative al pool di registrazione, al pool di registrazione di backup e al pool di servizi utente cui è stato assegnato un utente.
Sintassi
Get-CsUserPoolInfo -Identity <UserIdParameter> [-LocalStore <SwitchParameter>]
Descrizione dettagliata
Quando un utente viene abilitato per Microsoft Lync Server 2010, deve essere inserito in un pool di registrazione. Questo pool è responsabile dell'autenticazione dell'utente e deve tener traccia del suo stato e della sua ubicazione. Se è necessario conoscere il pool di registrazione al quale è stato assegnato l'utente è possibile recuperare questa informazione utilizzando un comando come questo:
Get-CsUser "Ken Myer" | Select-Object RegistrarPool
In molti casi, sapere il pool di registrazione di un utente è tutto quel che serve sapere. In altri casi, potrebbe essere necessario conoscere a quale pool di registrazione di backup è stato assegnato l'utente (il pool da utilizzare se il pool di registrazione primario non è disponibile), i nomi dei computer che compongono questo pool ed il pool servizi utente al quale è stato assegnato l'utente. Queste informazioni dettagliate possono essere recuperate eseguendo il cmdlet Get-CsUserPoolInfo.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsUserPoolInfo può essere utilizzato localmente dai membri dei seguenti gruppi: 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-CsUserPoolInfo"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
Parametro User ID |
Indica l'identità dell'utente di cui si stanno recuperando le informazioni relative al pool utente. Le identità utente possono essere specificate con uno dei quattro formati riportati di seguito: 1) l'indirizzo SIP dell'utente; 2) il nome dell'entità utente (UPN); 3) il nome del dominio e il nome di accesso dell'utente nel formato dominio\accesso (ad esempio, litwareinc\davidegarghentini); 4) il nome visualizzato Servizi di dominio Active Directory dell'utente (ad esempio, Davide Garghentini). È anche possibile fare riferimento a un account utente utilizzando il nome distinto Active Directory dell'utente. È possibile utilizzare il carattere jolly asterisco (*) quando si utilizza il nome visualizzato come identità utente. Ad esempio, il parametro Identity "* Smith" restituirà tutti gli utenti con cognome che termina con un valore di stringa " Smith". |
LocalStore |
Parametro opzionale |
Consente di recuperare le informazioni sul pool di utenti dalla replica locale di archivio di gestione centrale invece che da archivio di gestione centrale. |
Tipi di input
Stringa o oggetto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Set-CsUser accetta gli input tramite pipeline dei valori stringa che rappresentano SamAccountName di un account utente abilitato per Lync Server 2010. Il cmdlet accetta anche istanze di oggetti utente di Active Directory inviate tramite pipeline.
Tipi restituiti
Get-CsUserPoolInfo restituisce le istanze dell'oggetto Microsoft.Rtc.Management.Xds.GetOCsUserPoolInfoCmdlet+UserInformation.
Esempio
-------------------------- Esempio 1 ------------------------
Get-CsUserPoolInfo "sip:kenmyer@litwareinc.com"
Il comando precedente restituisce le informazioni pool di un singolo utente: l'utente con indirizzo SIP sip:davidegarghentini@litwareinc.com.
-------------------------- Esempio 2 ------------------------
Get-CsUser | Get-CsUserPoolInfo
nell'Esempio 2, le informazioni pool vengono restituite per tutti gli utenti abilitati per Lync Server 2010. Per eseguire questa operazione, il comando prima utilizza il cmdlet Get-CsUser senza alcun parametro per ottenere una raccolta di tutti gli utenti abilitati per Lync Server. Questa raccolta viene poi inviata tramite pipe al cmdlet Get-CsUserPoolInfo che visualizza le informazioni sul pool per ciascun utente nella raccolta.
-------------------------- Esempio 3 ------------------------
Get-CsUser | Where-Object {$_.RegistrarPool -ne $Null} | Get-CsUserPoolInfo
Il comando riportato nell'Esempio 3 è una variazione del comando utilizzato nell'Esempio 2 nel quale venivano restituite informazioni relative a tutti gli utenti abilitati per Lync Server. Tuttavia, è possibile che utenti siano stati abilitati per Lync Server ma non siano stati assegnati ad un pool di registrazione. Il comando riportato nell'Esempio 2 visualizza un messaggio di errore per ciascun utente che risponde a quei criteri, quei messaggi di errore vengono soppressi nell'Esempio 3.
Per eliminare i messaggi di errore nell'Esempio 3 viene utilizzato ancora Get-CsUser per recuperare una raccolta di tutti gli utenti abilitati per Lync Server. Questa volta, però, la raccolta viene inviata tramite pipe al cmdlet Where-Object che seleziona solo quegli utenti in cui la proprietà RegistrarPool non è uguale ad un valore nullo. In altre parole gli utenti a cui è stato assegnato un pool di registrazione. Questa raccolta filtrata viene poi inviata tramite pipe al cmdlet Get-CsUserPoolInfo che visualizza le informazioni sul pool per ciascun utente nella raccolta.
-------------------------- Esempio 4 ------------------------
Get-CsUser | Get-CsUserPoolInfo | Where-Object {$_.PrimaryPoolFqdn -eq "redmond-cs-001.litwareinc.com"}
Nel comando precedente, le informazioni pool vengono visualizzate per tutti gli utenti inseriti sul pool primario redmond-cs-001.litwareinc.com. Per ottenere questo risultato, viene utilizzato Get-CsUser per ottenere una raccolta di tutti gli utenti che sono stati abilitati per Lync Server. Questa raccolta viene inviata tramite pipe al cmdlet Get-CsUserPoolInfo che visualizza le informazioni sul pool per ciascun utente nella raccolta. A loro volta, queste informazioni vengono inviate tramite pipe al cmdlet Where-Object che seleziona solo quegli utenti in cui la proprietà PrimaryPoolFqdn è uguale a redmond-cs-001.litwareinc.com.
-------------------------- Esempio 5 ------------------------
Get-CsUser | Get-CsUserPoolInfo | Where-Object {$_.BackupPoolFqdn -eq $Null}
Il comando riportato nell'Esempio 5 restituisce le informazioni sul pool per tutti gli utenti ai quali non è stato assegnato un pool di registrazione di backup. Per ottenere questo risultato, il comando prima utilizza il cmdlet Get-CsUser per ottenere un raccolta di tutti gli utenti che sono stati abilitati per Lync Server. Questa raccolta viene inviata tramite pipe al cmdlet Get-CsUserPoolInfo che visualizza le informazioni sul pool per ciascun utente nella raccolta. Infine, le informazioni pool vengono inviate tramite pipe al cmdlet Where-Object che visualizza i dati solo per gli utenti in cui la proprietà BackupPoolFqdn è uguale a un valore nullo.
-------------------------- Esempio 6 ------------------------
Get-CsUserPoolInfo "Ken Myer" | Select-Object -Expand PrimaryPoolMachinesInPreferredOrder
Nell'Esempio 6 vengono riportate informazioni relative ai singoli computer che costituiscono il pool di registrazione di Davide Garghentini. Per recuperare questa informazione, viene prima utilizzato Get-CsUserPoolInfo per ottenere i dati pertinenti all'account utente Davide Garghentini. Questi dati verranno quindi inviati tramite pipe al cmdlet Select-Object. Select-Object utilizzati il parametro Expand per"espandere" le informazioni memorizzate nella proprietà PrimaryPoolMachinesInPreferredOrder. L'espansione di una proprietà significa semplicemente che tutti i valori memorizzati in quella proprietà verranno visualizzati sullo schermo con una disposizione di facile lettura.