Enable-CsUser
Ultima modifica dell'argomento: 2012-03-23
Consente di abilitare uno o più utenti per Microsoft Lync Server 2010. Gli utenti non possono utilizzare Microsoft Lync 2010, Lync Server 2010 o altri client Lync Server fin quando non sono stati abilitati i loro account utente.
Sintassi
Enable-CsUser -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-HostingProviderProxyFqdn <Fqdn>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-RegistrarPool <Fqdn>] [-SipAddress <String>] [-SipAddressType <FirstLastName | EmailAddress | UserPrincipalName | SAMAccountName | None>] [-SipDomain <Fqdn>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Prima di poter accedere a Lync Server, un utente deve soddisfare due requisiti: deve essere in possesso di un account di Active Directory valido e questo account deve essere abilitato per Lync Server. Un modo per abilitare un account utente per Lync Server è l'utilizzo del cmdlet Enable-CsUser. Per utilizzare questo cmdlet per abilitare un account per Lync Server è necessario: 1) Selezionare un account (o più account) da abilitare; 2) Selezionare un pool di registrazione per l'account; 3) Assegnare all'account un indirizzo SIP. Con Lync Server gli amministratori possono scegliere se assegnare all'utente uno specifico indirizzo SIP oppure lasciare che Lync Server lo crei automaticamente.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Enable-CsUser può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins. 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 "Enable-CsUser"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
UserIDParameter |
Indica l'identità dell'account utente da abilitare per Lync Server. 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". |
RegistrarPool |
Obbligatorio |
FQDN |
Indica il pool di registrazione in cui sarà inserito l'account Lync Server dell'utente. |
SipAddressType |
Facoltativo |
Stringa |
Indica a Lync Server di generare automaticamente un indirizzo SIP per il nuovo utente. Affinché Lync Server generi automaticamente l'indirizzo SIP, è necessario includere il parametro SipAddressType e utilizzare uno dei seguenti valori di parametro: FirstLastName. L'indirizzo SIP corrisponde al nome dell'utente, seguito da un punto, dal cognome dell'utente e dal dominio SIP. Ad esempio, per l'utente Davide Garghentini l'indirizzo SIP diventa: Ken.Myer@litwareinc.com. Se si utilizza questo tipo di indirizzo è necessario includere anche il parametro SipDomain. EmailAddress Come indirizzo SIP viene utilizzato l'indirizzo di posta elettronica dell'utente (definito in Active Directory). UserPrincipalName. L'UPN dell'utente viene utilizzato come indirizzo SIP. SamAccountName. L'indirizzo SIP corrisponde al SamAccountName (nome di accesso) dell'utente seguito dal dominio SIP. Ad esempio, per l'utente con SamAccountName kmyer l'indirizzo SIP diventa: kmyer@litwareinc.com. Se si utilizza questo tipo di indirizzo è necessario includere anche il parametro SipDomain. Il parametro SipAddressType non è richiesto se si utilizza il parametro SIPAddress e si assegna esplicitamente all'utente un indirizzo SIP. |
SipDomain |
Facoltativo |
Stringa |
Il dominio SIP per l'account utente in fase di abilitazione. Questo parametro è obbligatorio se si utilizza il parametro SIPAddressType per far sì che Lync Server generi automaticamente un indirizzo SIP per l'utente e se gli indirizzi SIP sono basati sul SamAccountName o sul nome e cognome dell'utente. Questo parametro non è necessario se l'indirizzo SIP viene basato sull'indirizzo di posta elettronica dell'utente o sull'UPN; dato che il nome del dominio è già incluso nei valori di questi attributi. |
SipAddress |
Facoltativo |
Stringa |
Consente di assegnare all'utente uno specifico indirizzo SIP. Quando si specifica l'indirizzo SIP, è necessario farlo precedere da "sip:". In pratica, il valore fornito al parametro SipAddress deve essere simile al seguente: sip:davidegarghentini@litwareinc.com Il parametro SipAddress non deve essere utilizzato con il cmdlet SipAddressType per fare in modo che Lync Server generi automaticamente un indirizzo SIP per l'utente. Il parametro The SipAddress non può essere utilizzato se vogliono abilitare più utenti nello stesso momento. Invece è possibile generare automaticamente gli indirizzi SIP per quegli utenti utilizzando il parametro SipAddressType. |
HostingProviderProxyFqdn |
Facoltativo |
Stringa |
Questo parametro è utilizzato solo per Microsoft Lync Online 2010. Non deve essere utilizzato con un'implementazione locale di Lync Server. |
ProxyPool |
Facoltativo |
Stringa |
Questo parametro è utilizzato solo per Lync Online 2010. Non deve essere utilizzato con un'implementazione locale di Lync Server. |
DomainController |
Facoltativo |
Stringa |
Consente di eseguire la connessione al controller di dominio specificato per abilitare un account utente. Per la connessione a un controller di dominio specifico, includere il parametro DomainController seguito dal nome computer (ad esempio, atl-cs-001) o dal nome di dominio completo (FQDN) (ad esempio, atl-cs-001.litwareinc.com). |
PassThru |
Facoltativo |
Parametro opzionale |
Consente di specificare attraverso la pipeline un oggetto utente che rappresenta l'account utente che si sta abilitando per Lync Server. Per impostazione predefinita, il cmdlet Enable-CsUser non fornisce alcun oggetto attraverso la pipeline. |
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. Enable-CsUser accetta gli input tramite pipeline dei valori stringa che rappresentano l'identità di un account utente abilitato per Lync Server. Il cmdlet accetta anche istanze di oggetti utente di Active Directory inviate tramite pipeline.
Tipi restituiti
Nessuno. Enable-CsUser non restituisce alcun oggetto o valore. In realtà, il cmdlet consente di configurare le istanze dell'oggetto Microsoft.Rtc.Management.ADConnect.Schema.ADUser.
Esempio
-------------------------- Esempio 1 --------------------------
Enable-CsUser -Identity "Pilar Ackerman" -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddressType SamAccountName -SipDomain litwareinc.com
Nell'Esempio 1 Enable-CsUser consente di abilitare l'account utente con il nome visualizzato Luisa Cazzaniga. In questo esempio, l'utente viene assegnato al pool di registrazione atl-cs-001.litwareinc.com e Lync Server genera automaticamente l'indirizzo SIP utilizzando il valore di SamAccountName (pilar) dell'utente seguito da dominio SIP litwareinc.com.
-------------------------- Esempio 2 --------------------------
Enable-CsUser -Identity "Pilar Ackerman" -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddress "sip:pilar@litwareinc.com"
Nell'esempio precedente l'account utente di Active Directory appartenente a Luisa Cazzaniga viene abilitato per l'utilizzo con Lync Server. Per configurare l'account per Lync Server vengono utilizzati i parametri eseguenti insieme a Enable-CsUser: Identity, che identifica l'account da abilitare, RegistrarPool, che indica il server Standard Edition o il pool Enterprise Edition Front End in cui deve trovarsi l'utente, e SipAddress, che specifica l'indirizzo SIP per il nuovo utente. In questo caso, l'indirizzo SIP viene assegnato in modo esplicito anziché utilizzando Lync Server per generare automaticamente l'indirizzo.
-------------------------- Esempio 3 --------------------------
Get-CsAdUser -LDAPFilter "department=Finance" | Enable-CsUser -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddressType SamAccountName -SipDomain litwareinc.com
Con l'esempio 3 gli account di tutti gli utenti che lavorano nel reparto Finance vengono abilitati per Lync Server. Per eseguire questa operazione, il comando utilizza il cmdlet Get-CsAdUser insieme al parametro LDAPFilter per ottenere una raccolta di tutti gli utenti che lavorano nel reparto Finance. Enable-CsUserEnable-CsUser, che abilita ogni account nella raccolta per Lync Server.
Per abilitare un account è necessario specificare il pool di registrazione e l'indirizzo SIP dell'utente. In questo esempio il pool di registrazione viene specificato utilizzando il parametro RegistrarPool. L'indirizzo SIP non viene però assegnato direttamente. Vengono infatti aggiunti al comando due parametri, SipAddressType e SipDomain. Questo significa che un nuovo indirizzo SIP viene generato automaticamente per ogni account, costituito dal SamAccountName dell'utente e dal nome di dominio SIP. Ad esempio, un utente con SAMAccountName davidegarghentini otterrà l'indirizzo SIP sip:davidegarghentini@litwareinc.com.
-------------------------- Esempio 4 --------------------------
Get-CsAdUser -Filter {Enabled -ne $True} | Enable-CsUser -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddressType SamAccountName -SipDomain litwareinc.com
Con il comando precedente vengono abilitati tutti gli utenti di Active Directory che non sono ancora stati abilitati per Lync Server. Per ottenere questo risultato, viene utilizzato il cmdlet Get-CsAdUser con il parametro Filter. Il filtro {Enabled -ne $True} restituisce una raccolta di tutti gli utenti che non sono stati abilitati per Lync Server. Tale raccolta viene inviata tramite pipe al cmdlet Enable-CsUser che abilita ciascun account, assegna l'utente al pool di registrazione atl-cs-001.litwareinc.com e genera automaticamente un indirizzo SIP per ogni utente.