Set-CsClientPin
Ultima modifica dell'argomento: 2012-03-25
Assegna un nuovo codice PIN all'utente specificato.
Sintassi
Set-CsClientPin -Identity <UserIdParameter> [-Pin <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Lync Server 2010 consente agli utenti di connettersi al sistema o di partecipare a conferenze PSTN (Public Switched Telephone Network) tramite telefono. Per accedere al sistema o partecipare a una conferenza, l'utente in genere deve immettere un nome utente o una password. L'immissione del nome utente e della password può tuttavia costituire un problema se il telefono in uso non dispone di una tastiera alfanumerica. Per questo motivo, con Lync Server 2010 è possibile fornire agli utenti codici PIN solo numerici. Quando richiesto, gli utenti possono quindi accedere al sistema o partecipare a una conferenza immettendo il codice PIN anziché il nome utente e la password.
Quando gli utenti sono abilitati per Lync Server 2010, non viene loro assegnato un codice PIN. Questo significa che, per impostazione predefinita, gli utenti non possono accedere al sistema utilizzando l'autenticazione tramite PIN. Gli utenti possono ottenere un codice PIN dalla pagina Web Conferenza telefonica con accesso esterno. In alternativa, gli amministratori possono assegnare a ciascun utente un codice PIN utilizzando il cmdlet Set-CsClientPin. Con Set-CsClientPin è possibile assegnare a un utente un codice PIN specifico o lasciare che sia Lync Server 2010 a generarne uno automaticamente. Per generare automaticamente un codice PIN, è sufficiente omettere il parametro PIN quando si chiama Set-CsClientPin. In tal modo, verrà generato un nuovo codice PIN che verrà visualizzato insieme all'identità dell'utente al termine dell'esecuzione del comando.
I codici PIN assegnati esplicitamente devono soddisfare le condizioni specificate nel criterio di autenticazione tramite PIN che si applica all'utente in questione. Il codice PIN ad esempio deve contenere almeno tante cifre quante ne sono previste dalla proprietà MinPasswordLength. I codici PIN inoltre possono contenere solo caratteri numerici. Le lettere e qualsiasi altro carattere non numerico non sono consentiti.
Quando si imposta un codice PIN client utilizzando Set-CsClientPin, il conteggio della cronologia PIN non viene applicato. Si supponga ad esempio che un utente disponga del codice PIN 12345 e che il criterio PIN client impedisca il riutilizzo immediato dello stesso codice. Se l'utente tenta di rinnovare il proprio codice PIN client tramite la pagina Web Conferenza telefonica con accesso esterno, qualsiasi tentativo di riutilizzare lo stesso codice (12345) verrà rifiutato. Utilizzando Set-CsClientPin, un amministratore può tuttavia assegnare il codice PIN 12345 allo stesso utente. Ciò è dovuto al fatto che Set-CsClientPin non è vincolato dal conteggio della cronologia del criterio PIN.
Per impostazione predefinita, le eccezioni del firewall per SQL Server Express non sono abilitate quando si installa Lync Server 2010 Standard Edition. Questo significa che non sarà possibile eseguire Set-CsClientPin da un'istanza remota di Windows PowerShell, dal momento che il comando non sarà in grado di attraversare il firewall e accedere al database di SQL Server Express. Sarà comunque possibile eseguire il cmdlet localmente sul server Standard Edition. Per poter eseguire Set-CsClientPin in remoto su un server Standard Edition, sarà necessario abilitare manualmente le eccezioni del firewall per SQL Server Express.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsClientPin i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsClientPin"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
UserIDParameter |
Identità dell'account utente per cui deve essere impostato il codice PIN. 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, User Principal Name), 3) il nome di 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). È possibile fare riferimento alle identità utente anche utilizzando il nome distinto Active Directory dell'utente. È inoltre possibile utilizzare il carattere jolly asterisco (*) quando si utilizza il valore di Display Name come parametro Identity dell'utente. Ad esempio, l'identità "* Smith" restituisce tutti gli utenti il cui nome visualizzato termina con il valore stringa " Smith". |
Pin |
Facoltativo |
Numero intero |
Codice PIN facoltativo da assegnare all'utente. Se non si include il parametro PIN, Lync Server 2010 genererà in modo casuale un codice PIN e lo assegnerà all'utente in questione. Il codice PIN deve rispettare le impostazioni relative alla lunghezza minima e ai modelli comuni specificate nel criterio PIN client assegnato all'utente. |
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
Valore stringa o oggetto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Set-CsClientPin accetta l'input da pipeline di valori stringa che rappresentano l'identità di un account utente. Il cmdlet accetta inoltre l'input da pipeline di oggetti utente.
Tipi restituiti
Set-CsClientPin non restituisce un valore o un oggetto. Il cmdlet configura istanze dell'oggetto Microsoft.Rtc.Management.UserPinService.PinInfoDetails.
Esempio
-------------------------- Esempio 1 ------------------------
Set-CsClientPin -Identity "litwareinc\kenmyer"
Nell'esempio 1 all'utente litwareinc\davidegarghentini viene assegnato un nuovo codice PIN generato automaticamente. Per assegnare un codice PIN generato automaticamente, è sufficiente omettere il parametro Pin quando si chiama Set-CsClientPin. Al termine dell'esecuzione del comando, il nuovo codice PIN assegnato a Davide Garghentini verrà visualizzato e tali informazioni potranno quindi essere inoltrate all'utente.
-------------------------- Esempio 2 ------------------------
Set-CsClientPin -Identity "litwareinc\kenmyer" -Pin 18723834
Il comando nell'esempio 2 assegna il PIN 18723834 all'utente litwareinc\davidegarghentini. Per assegnare un codice PIN specifico, è possibile utilizzare il parametro Pin seguito dal codice da assegnare.
-------------------------- Esempio 3 ------------------------
Get-CsUser -OU "OU=Finance,DC=litwareinc,DC=com" | Set-CsClientPin
Nell'esempio 3 viene mostrato come assegnare automaticamente nuovi codici PIN a tutti gli utenti di una determinata unità organizzativa di Active Directory. A tale scopo, viene utilizzato Get-CsUser con il parametro OU per restituire una raccolta di tutti gli utenti con account nell'unità organizzativa Finance. Questa raccolta viene quindi inviata tramite pipe a Set-CsClientPin, che genera un nuovo codice PIN per ciascun utente presente nella raccolta.
-------------------------- Esempio 4 ------------------------
Get-CsUser | Get-CsClientPinInfo | Where-Object {$_.IsPinSet -eq $False} | Set-CsClientPin
Il comando mostrato nell'esempio 4 assegna un nuovo codice PIN a tutti gli utenti che attualmente ne sono privi. A tale scopo, viene utilizzato Get-CsUser per restituire una raccolta di tutti gli utenti che sono stati abilitati per Lync Server 2010. Questa raccolta viene quindi inviata tramite pipe ai cmdlet Get-CsClientPin e Where-Object. Questi due cmdlet consentono di selezionare solo gli utenti la cui proprietà IsPinSet è uguale a False. La raccolta risultante, che contiene solo gli utenti che non hanno un codice PIN, viene quindi inviata tramite pipe a Set-CsClientPin, che genera automaticamente un codice PIN per ciascun utente presente nella raccolta.