Remove-CsPinPolicy
Ultima modifica dell'argomento: 2012-03-27
Consente di rimuovere il criterio PIN specificato. L'autenticazione tramite PIN e i criteri per il PIN consentono agli utenti di accedere a Microsoft Lync Server 2010 immettendo il proprio codice PIN invece che il nome utente e la password.
Sintassi
Remove-CsPinPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <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. 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 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, nonché stabilire se sono accettabili i PIN che utilizzano "formati comuni", come cifre consecutive (ad esempio, il PIN 123456). Oltre al criterio PIN globale, creato automaticamente quando si installa Lync Server 2010, è possibile creare criteri per il PIN personalizzati applicabili nell'ambito del sito o per utente.
Il cmdlet Remove-CsPinPolicy consente di rimuovere i criteri per il PIN configurati nell'ambito del sito o per utente. Quando si rimuove un criterio nell'ambito del sito o nell'ambito per utente, il criterio verrà eliminato e non sarà più disponibile per l'utilizzo. Inoltre, tutti gli utenti a cui sono stati assegnati quei criteri erediteranno automaticamente il criterio successivo nella gerarchia dei criteri (globale, sito, servizio, per utente). Ad esempio, se si rimuove un criterio a livello di sito, tutti gli utenti a cui era stato assegnato quel criterio avranno le proprie impostazioni per il PIN gestite dal criterio globale.
Il cmdlet Remove-CsPinPolicy può anche essere eseguito per il criterio globale. In questo caso, tuttavia, il criterio non verrà rimosso: questo perché non è possibile eliminare il criterio globale. Ciò che accade, però, è che per tutte le proprietà del criterio globale verranno ripristinati i valori predefiniti. Ad esempio, si supponga si aver configurato il criterio globale in modo da poter utilizzare un PIN con una lunghezza minima di 11 cifre. Se si rimuove il criterio globale, per la lunghezza minima del PIN verrà ripristinato il valore predefinito (5 cifre).
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Remove-CsPinPolicy 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 "Remove-CsPinPolicy"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
XdsIdentity |
Identificatore univoco assegnato al criterio al momento della sua 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 RedmondPINPolicy. |
Force |
Facoltativo |
Parametro opzionale |
Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando. |
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
Oggetto Microsoft.Rtc.Management.WritableConfig.Policy.UserPin.UserPolicy. Remove-CsPinPolicy accetta le istanze dell'oggetto criterio PN inviate tramite pipeline.
Tipi restituiti
Remove-CsPinPolicy non restituisce alcun oggetto o valore. Il cmdlet rimuove una o più istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.UserPin.UserPolicy.
Esempio
-------------------------- Esempio 1 --------------------------
Remove-CsPinPolicy -Identity RedmondUsersPinPolicy
Il comando precedente consente di rimuovere il criterio PIN per utente con identità RedmondUsersPinPolicy.
-------------------------- Esempio 2 --------------------------
Get-CsPinPolicy -Filter "site:*" | Remove-CsPinPolicy
Il comando riportato nell'Esempio 2 rimuove tutti i criteri relativi ai PIN configurati nell'ambito del sito. Per ottenere questo risultato, viene utilizzato il cmdlet Get-CsPinPolicy con il parametro Filter che restituisce una raccolta di tutti i criteri la cui identità inizia con i caratteri "site:". Questa raccolta viene quindi inviata tramite pipe al cmdlet Remove-CsPinPolicy che elimina ogni singolo criterio nella raccolta.
-------------------------- Esempio 3 --------------------------
Get-CsPinPolicy | Where-Object {$_.AllowCommonPatterns -eq $True} | Remove-CsPinPolicy
Nell'Esempio 3, vengono utilizzati i cmdlet Get-CsPinPolicy, Where-Object e Remove-CsPinPolicy per eliminare tutti i criteri per il PIN in cui la proprietà AllowCommonPatterns è impostata su True. Per ottenere questo risultato, viene utilizzato il cmdlet Get-CsPinPolicy per ottenere una raccolta di tutti i criteri per il PIN configurati per l'utilizzo nell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo i criteri in cui AllowCommonPatterns è uguale a True. La raccolta filtrata viene a sua volta inviata tramite pipe al cmdlet Remove-CsPinPolicy che elimina ogni singolo criterio nella raccolta.
-------------------------- Esempio 4 --------------------------
Get-CsPinPolicy | Remove-CsPinPolicy
Il comando riportato nell'Esempio 4 consente di eliminare tutti i criteri per il PIN configurati nell'ambito del sito e per utente. Per ottenere questo risultato, il cmdlet Get-CsPinPolicy viene utilizzando per ottenere una raccolta di tutti i criteri per il PIN configurati per l'utilizzo nell'organizzazione e quindi l'intera raccolta viene inviata tramite pipe al cmdlet Remove-CsPinPolicy. Si noti che in questa raccolta sarà incluso anche il criterio globale. Tuttavia, il criterio globale non verrà eliminato. Ciò che accade è che per tutte le proprietà del criterio globale verranno ripristinati i valori predefiniti.