Get-CsPinPolicy
Ultima modifica dell'argomento: 2012-03-23
Restituisce informazioni sui criteri di autenticazione dei PIN client configurati per l'utilizzo nella propria organizzazione. L'autenticazione tramite PIN consente agli utenti di accedere a Microsoft Lync Server 2010 immettendo il proprio codice PIN invece che il nome utente e la password.
Sintassi
Get-CsPinPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsPinPolicy [-Filter <String>] [-LocalStore <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. In genere, l'accesso al sistema o la partecipazione a una conferenza comporta l'immissione di un ID utente e una password da parte dell'utente; tuttavia, questo potrebbe essere un problema nel caso in cui l'utente stia utilizzando 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.
In Lync Server vengono utilizzati i criteri per il PIN per gestire le proprietà di autenticazione tramite PIN. È ad esempio possibile specificare una lunghezza minima per un codice PIN e stabilire se sono accettabili i PIN che utilizzano "formati comuni", come cifre consecutive (ad esempio, il PIN 123456). È possibile utilizzare il cmdlet Get-CsPinPolicy per recuperare le informazioni sui criteri per il PIN attualmente configurati per l'utilizzo nella propria organizzazione.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsPinPolicy può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins, 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-CsPinPolicy"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
XdsIdentity |
Identità univoca assegnata al criterio al momento della creazione. È possibile assegnare i criteri relativi ai PIN in ambito globale, del sito o per utente. Per fare riferimento all'istanza globale, utilizzare la seguente sintassi: -Identity global. Per fare riferimento a un criterio nell'ambito del sito, utilizzare la seguente sintassi: -Identity site:Redmond. Per fare riferimento a un criterio nell'ambito per utente, utilizzare una sintassi simile alla seguente: -Identity RedmondPolicy. Non è possibile utilizzare i caratteri jolly, come l'asterisco (*), con il parametro Identity. Per cercare i criteri utilizzando i caratteri jolly, utilizzare il parametro Filter. Se non si specifica né il parametro Identity né il parametro Filter, il cmdlet Get-CsPinPolicy restituisce le informazioni su tutti i criteri per il PIN configurati per l'utilizzo nella propria organizzazione. |
Filter |
Facoltativo |
Stringa |
Consente di utilizzare i caratteri jolly per ricercare i criteri dei PIN. Ad esempio, per trovare tutti i criteri configurati nell'ambito del sito, utilizzare il seguente valore per Filter: site:*. Per trovare i criteri nell'abito dei siti Seattle, Seville e Saskatoon (tutti nomi che iniziano con la lettera "S"), utilizzare il seguente filtro: site:S*. Si noti che questo parametro può filtrare solo i valori della proprietà Identity. |
LocalStore |
Facoltativo |
Parametro opzionale |
Consente di recuperare i dati dei criteri per il PIN dalla replica locale di archivio di gestione centrale invece che da archivio di gestione centrale. |
Tipi di input
Nessuno. Get-CsPinPolicy non accetta input tramite pipeline.
Tipi restituiti
Get-CsPinPolicy restituisce una o più istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.UserPin.UserPinPolicy.
Esempio
-------------------------- Esempio 1 --------------------------
Get-CsPinPolicy
Il comando riportato nell'Esempio 1 restituisce una raccolta di tutti i criteri dei PIN configurati per l'utilizzo nell'organizzazione. Se si utilizza il cmdlet Get-CsPinPolicy senza specificare un valore per il parametro Identity, si ottiene la raccolta completa di tutti i criteri per il PIN.
-------------------------- Esempio 2 --------------------------
Get-CsPinPolicy -Identity "site:Redmond"
L'Esempio 2 restituisce un singolo criterio dei PIN: il criterio con Identity site:Redmond.
-------------------------- Esempio 3 --------------------------
Get-CsPinPolicy -Filter "tag:*"
Il comando riportato nell'Esempio 3 utilizza il parametro Filter per ottenere una raccolta di tutti i criteri che sono stati configurati nell'ambito per utente. Per ottenere questo risultato, viene utilizzato il valore del filtro "tag:*"; questo valore fa in modo che il cmdlet Get-CsPinPolicy restituisca solo quei criteri la cui identità inizia con la stringa "tag:".
-------------------------- Esempio 4 --------------------------
Get-CsPinPolicy | Where-Object {$_.AllowCommonPatterns -eq $True}
Nell'Esempio 4 vengono restituiti tutti i criteri per il PIN in cui la proprietà AllowCommonPatterns è impostata su True. In questo esempio viene utilizzato il cmdlet Get-CsPinPolicy senza parametri aggiuntivi; il cmdlet restituisce una raccolta di tutti i criteri per il PIN configurati per l'utilizzo nell'organizzazione. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdletWhere-Object che seleziona solo quei criteri in cui la proprietà AllowCommonPatterns è uguale a True.
-------------------------- Esempio 5 --------------------------
Get-CsPinPolicy | Where-Object {$_.PinLifetime -gt 30}
Come nell'Esempio 4, il comando riportato nell'Esempio 5 utilizza il cmdlet Where-Object per ottenere un sottoinsieme di criteri per il PIN. In questo caso, il cmdlet Where-Object consente di recuperare solo quei parametri per i quali la proprietà PinLifetime è maggiore di 30. Ciò significa che verranno restituiti soli i criteri per il PIN con scadenza superiore ai 30 giorni.