Set-CsUser
Ultima modifica dell'argomento: 2012-03-26
Consente di modificare le proprietà di Microsoft Lync Server 2010 per un account utente. Le proprietà possono essere modificate solo per gli account abilitati all'uso di Lync Server 2010.
Sintassi
Set-CsUser -Identity <UserIdParameter> [-AcpInfo <MultiValuedProperty>] [-AudioVideoDisabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-HostedVoiceMail <Nullable>] [-LineServerURI <String>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-PrivateLine <String>] [-RemoteCallControlTelephonyEnabled <$true | $false>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Set-CsUser consente di modificare gli attributi degli account utente relativi a Lync Server archiviati in Servizi di dominio Active Directory. Ad esempio, è possibile disabilitare o riabilitare un utente per Lync Server, abilitare o disabilitare un utente per le comunicazioni audio/video (A/V) o modificare i numeri della linea privata e dell'URI di linea dell'utente. Set-CsUser può essere utilizzato solo per gli utenti che sono stati abilitati a Lync Server.
I soli attributi che si possono modificare utilizzando Set-CsUser sono gli attributi relativi a Lync Server. Gli altri attributi dell'account utente, come la qualifica o il reparto dell'utente, non possono essere modificati utilizzando questo cmdlet.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-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 "Set-CsUser\b"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
XdsIdentity |
Indica l'identità dell'account utente da modificare. Le identità dell'utente possono essere specificate utilizzando uno dei seguenti quattro formati: 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 nella forma dominio\accesso (ad esempio, litwareinc\davidegarghentini); 4) il nome visualizzato Active Directory dell'utente (ad esempio, Davide Garghentini). Alle identità utente è anche possibile fare riferimento 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 " Smith". |
ACPInfo |
Facoltativo |
Array di oggetti ACPInfo |
Consente di assegnare a un utente uno o più provider di servizi di audioconferenza di terze parti. Tuttavia, si raccomanda di utilizzare il cmdlet Set-UserAcp per assegnare provider di audioconferenza. |
AudioVideoDisabled |
Facoltativo |
Booleano |
Indica se all'utente è consentito effettuare chiamate audio/video (A/V) utilizzando Lync 2010. Se è impostato su False, l'utente avrà notevoli limitazioni nell'invio e nella ricezione di messaggi istantanei. Non è possibile disabilitare le comunicazioni A/V se un utente è attualmente abilitato al controllo delle chiamate remote, VoIP aziendale e/o il soft routing IP-PBX (Internet Protocol private branch exchange). |
Enabled |
Facoltativo |
Booleano |
Indica se l'utente è stato abilitato per Lync Server. Se questo valore viene impostato su False, l'utente non potrà più accedere a Lync Server; se il valore viene impostato su True vengono riabilitati i privilegi di accesso dell'utente. Se si disabilita un account utilizzando il parametro Enabled, le informazioni associate a tale account (compresi i criteri assegnati e l'abilitazione dell'utente per VoIP aziendale, il controllo delle chiamate remote) vengono mantenute. Se in seguito si riabilita l'account utilizzando il parametro Enabled, le informazioni sull'account associate vengono ripristinate. Questo comportamento è diverso dall'uso del cmdlet Disable-CsUser per disabilitare un account utente. Quando si esegue Disable-CsUser, tutti i dati di Lync Server associati a tale account vengono eliminati. |
DomainController |
Facoltativo |
Stringa |
Consente di specificare un controller di dominio a cui effettuare la connessione per modificare un account utente. Se questo parametro non viene specificato, il cmdlet utilizzerà il primo controller di dominio disponibile. |
EnterpriseVoiceEnabled |
Facoltativo |
Booleano |
Indica se l'utente è stato abilitato per VoIP aziendale, l'implementazione Microsoft di VoIP (Voice over Internet Protocol). Con VoIP aziendale gli utenti possono effettuare telefonate via Internet senza utilizzare la rete telefonica standard. |
HostedVoiceMail |
Facoltativo |
Booleano |
Se impostato su True, consente di abilitare la segreteria telefonica di un utente per instradare le chiamate a una versione ospitata di Microsoft Exchange Server. Inoltre, impostando questa opzione su True, si abilitano gli utenti di Lync 2010 a effettuare una chiamata direttamente alla segreteria telefonica di un altro utente. |
LineURI |
Facoltativo |
Stringa |
Numero telefonico assegnato all'utente. L'URI (Uniform Resource Identifier) di linea deve essere specificato utilizzando il formato E.164 e il prefisso "TEL:". Ad esempio: TEL:+14255551297. Qualsiasi numero di interno deve essere aggiunto alla fine dell'URI di linea, ad esempio: TEL:+14255551297;ext=51297. È importante notare che in Lync Server TEL:+14255551297 e TEL:+14255551297;int=51297 vengono trattati come due numeri diversi. Se si assegna a Davide Garghentini l'URI di linea TEL:+14255551297 e successivamente si tenta di assegnare a Luisa Cazzaniga l'URI di linea TEL:+14255551297;ext=51297, tale assegnazione avrà esito positivo. Il numero assegnato a Pilar non verrà contrassegnato come numero duplicato. Ciò è dovuto al fatto che, a seconda della configurazione, i due numeri potrebbero effettivamente essere diversi. In alcune organizzazioni, ad esempio, se si compone 1-425-555-1297 la chiamata viene inoltrata all'Operatore automatico di Exchange. Al contrario, se si compone solo il numero di interno (51297) o se si utilizza Microsoft Lync 2010 per comporre il numero 1-425-555-1297 interno 51297, la chiamata viene inoltrata direttamente all'utente. |
LineServerURI |
Facoltativo |
Stringa |
L'URI del gateway telefonico di controllo delle chiamate remote assegnato all'utente. LineServerUri è l'URI gateway, preceduto da "sip:". Ad esempio: sip:rccgateway@litwareinc.com |
PrivateLine |
Facoltativo |
Stringa |
Il numero di telefono della linea telefonica privata dell'utente. Una linea privata è un numero di telefono che non è pubblicato in Servizi di dominio Active Directory e che quindi non è immediatamente disponibile alle altre persone. Inoltre, questa linea privata ignora la maggior parte delle regole di routing per le chiamate in entrata; ad esempio, una chiamata a una linea privata non viene inoltrata ai delegati di una persona. Le linee private sono spesso utilizzate per le telefonate personali o per le chiamate di affari che non riguardano gli altri membri del team. La linea privata deve essere specificata utilizzando il formato E.164 e il prefisso "TEL:". Ad esempio: TEL:+14255551297. |
RemoteCallControlTelephonyEnabled |
Facoltativo |
Booleano |
Indica se l'utente è stato abilitato alla telefonia con controllo delle chiamate remote. Se è abilitato al controllo delle chiamate remote, un utente può utilizzare Lync Server per rispondere alle chiamate effettuate al telefono della sua scrivania. È inoltre possibile effettuare le telefonate utilizzando Lync 2010. Queste chiamate fanno affidamento sulla rete telefonica standard, chiamata anche PSTN (Public Switched Telephone Network). Per effettuare e ricevere telefonate su Internet, l'utente deve essere abilitato per VoIP aziendale. Per informazioni dettagliate, vedere il parametro EnterpriseVoiceEnabled. Per essere abilitato al controllo delle chiamate remote, un utente deve disporre sia di LineUri che di LineServerUri. |
SipAddress |
Facoltativo |
Stringa |
Identificatore univoco (simile a un indirizzo di posta elettronica) che consente all'utente di comunicare utilizzando dispositivi SIP come Lync 2010. L'indirizzo SIP deve utilizzare e SIP sip: come prefisso e un valido dominio SIP; ad esempio: -SipAddress sip:davidegarghentini@litwareinc.com. |
PassThru |
Facoltativo |
Parametro opzionale |
Consente di specificare attraverso la pipeline un oggetto utente che rappresenta l'utente di cui si sta modificando l'account. Per impostazione predefinita, il cmdlet Set-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. Set-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
Set-CsUser non restituisce alcun oggetto.
Esempio
-------------------------- Esempio 1 --------------------------
Set-CsUser -Identity "Pilar Ackerman" -EnterpriseVoiceEnabled $True
Nell'Esempio 1, viene utilizzato Set-CsUser per modificare l'account utente con Identity Luisa Cazzaniga. In questo caso, l'account viene modificato per abilitare VoIP aziendale, l'implementazione Microsoft di VoIP. Per ottenere questo risultato, si aggiunge il parametro EnterpriseVoiceEnabled e si imposta il valore del parametro su $True.
-------------------------- Esempio 2 --------------------------
Get-CsUser -LdapFilter "Department=Finance" | Set-CsUser -EnterpriseVoiceEnabled $True
Nell'Esempio 2, gli account di tutti gli utenti del reparto Finance vengono abilitati per VoIP aziendale. In questo comando, viene utilizzato prima il cmdlet Get-CsUser insieme a LDAPFilter per ottenere una raccolta di tutti gli utenti che lavorano nel reparto Finance. Tali informazioni vengono quindi inviate tramite pipe al cmdlet Set-CsUser che abilita VoIP aziendale per ogni account della raccolta.