Get-CsClientPinInfo
Ultima modifica dell'argomento: 2012-03-23
Consente di recuperare informazioni sul PIN assegnato ad un utente.
Sintassi
Get-CsClientPinInfo -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Lync Server 2010 consente agli utenti di connettersi al sistema o di partecipare alle conferenze PSTN (Public Switched Telephone Network) tramite telefono. Generalmente, per poter accedere al sistema o partecipare a una conferenza, l'utente deve immettere un nome utente e una password. Questo può rappresentare un problema se si utilizza un telefono privo di tastierino alfanumerico. Per questo motivo, Lync Server 2010 consente di creare e assegnare agli utenti dei codici PIN numerici in modo che possano accedere al sistema o partecipare a una conferenza immettendo, quando richiesto, il proprio PIN al posto dell'ID utente e della password.
Gli amministratori possono recuperare le impostazioni PIN di un utente o di un gruppo di utenti eseguendo il cmdlet Get-CsClientPinInfo. Si noti che un amministratore non può recuperare il PIN assegnato a un utente. Se un utente dimentica il proprio PIN, non sarà più in grado di usare l'autenticazione tramite PIN per accedere al sistema fino a quando un amministratore non gli assegnerà un nuovo PIN o fino a quando l'utente non otterrà un nuovo PIN dalla pagina Web relativa alla conferenza telefonica con accesso esterno.
Si noti che, per impostazione predefinita, le eccezioni firewall per SQL Server Express non sono abilitate quando si installa la versione Standard Edition di Lync Server 2010. Ciò significa che non sarà possibile utilizzare il cmdlet Get-CsClientPinInfo da un'istanza remota di Windows PowerShell perché il comando non è in grado di attraversare il firewall e accedere al database di SQL Server Express. È comunque possibile utilizzare il cmdlet localmente su Server Standard. Per utilizzare il cmdlet Get-CsClientPinInfo in remoto su Server Standard, è necessario abilitare manualmente le eccezioni firewall per SQL Server Express.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsClientPinInfo può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. 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-CsClientPinInfo"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
Parametro ID utente |
Indica l'identità dell'account utente il cui PIN deve essere bloccato. 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 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 un nome visualizzato che termina con il valore di stringa " Smith". |
WhatIf |
Facoltativo |
Parametro opzionale |
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente. |
Confirm |
Facoltativo |
Parametro opzionale |
Viene visualizzata una richiesta di conferma prima di eseguire il comando. |
Tipi di input
Stringa o oggetto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Get-CsClientPinInfo accetta gli input tramite pipeline dei valori stringa che rappresentano l'identità di un account utente. Il cmdlet accetta anche gli input tramite pipeline degli oggetti utente.
Tipi restituiti
Get-CsClientPinInfo restituisce una o più istanze dell'oggetto Microsoft.Rtc.Management.UserPinService.PinInfoDetails.
Esempio
-------------------------- Esempio 1 --------------------------
Get-CsUser | Get-CsClientPinInfo
Il comando precedente restituisce le informazioni sul PIN di tutti gli utenti abilitati per Lync Server 2010. Per ottenere questo risultato, il comando utilizza il cmdlet Get-CsUser per ottenere tutti gli utenti abilitati per Lync Server 2010. Questa raccolta viene poi inviata tramite pipe al cmdlet Get-CsClientPinInfo che visualizza le informazioni sul PIN di ciascun utente nella raccolta.
-------------------------- Esempio 2 --------------------------
Get-CsClientPinInfo -Identity "litwareinc\kenmyer"
Nell'Esempio 2 viene utilizzato il cmdlet Get-CsClientPinInfo per visualizzare le informazioni sul PIN di un singolo utente: l'utente con Identity litwareinc\davidegarghentini.
-------------------------- Esempio 3 --------------------------
Get-CsUser -OU "OU=Finance,DC=litwareinc,DC=com" | Get-CsClientPinInfo
L'Esempio 3 restituisce le informazioni sul PIN per tutti gli utenti con un account nell'unità organizzativa Finance. Per ottenere questo risultato, vengono utilizzati il cmdlet Get-CsUser e il parametro OU (unità organizzativa) per ottenere una raccolta di tutti gli utenti nell'unità Finance. Questa raccolta viene poi inviata tramite pipe al cmdlet Get-CsClientPinInfo che visualizza le informazioni sul PIN di ciascun utente nella raccolta.
-------------------------- Esempio 4 --------------------------
Get-CsUser -LdapFilter "Title=Manager" | Get-CsClientPinInfo
Il comando riportato nell'Esempio 4 consente di visualizzare le informazioni PIN di tutti i manager nell'organizzazione. Per ottenere una raccolta di tutti i manager, il comando utilizza il cmdlet Get-CsUser e il parametro LdapFilter; il valore del filtro "Title=Manager" restituisce solo i dati relativi agli utenti la cui qualifica è "Manager". Viene poi utilizzato il cmdlet Get-CsClientPinInfo per visualizzare le informazioni sul PIN di ciascuno di questi utenti.