Disable-CsUser
Ultima modifica dell'argomento: 2012-03-23
Consente di modificare l'account Active Directory dell'utente o degli utenti specificati; questa modifica impedisce agli utenti di utilizzare i client Microsoft Lync Server 2010 come Microsoft Lync 2010. Disable-CsUser consente di limitare solo le attività relative a Lync Server 2010; non disabilita né rimuove l'account Active Directory di un utente.
Sintassi
Disable-CsUser -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Il cmdlet Disable-CsUser consente di eliminare tutte le informazioni sugli attributi relative a Lync Server da un account utente Active Directory; in questo modo si impedisce all'utente di accedere a Lync Server. Quando si esegue Disable-CsUser, tutti gli attributi relativi a Lync Server vengono rimossi da un account, comprese le identità di eventuali criteri per utente assegnati a tale account. In seguito è possibile riabilitare l'account utilizzando il cmdlet Enable-CsUser. Tuttavia, tutte le informazioni relative a Lync Server (quali le assegnazioni dei criteri) precedentemente associate all'account dovranno essere ricreate. Per impedire a un utente di accedere a Lync Server senza perdere le informazioni sull'account, utilizzare Set-CsUser. Per informazioni dettagliate, vedere l'argomento della Guida Set-CsUser.
Dopo aver disabilitato un account con Disable-CsUser, l'utente interessato non sarà più restituito dal cmdlet Get-CsUser, perché l'utente non dispone più di un account Lync Server valido. Per recuperare le informazioni per l'account utente disabilitato utilizzare Get-CsAdUser.
Inoltre, i dati utente appartenenti all'account utente eliminato saranno rimossi dai database di back-end; ad esempio, l'utente sarà rimosso dall'elenco Contatti nell'organizzazione e le eventuali conferenze pianificate dall'utente saranno eliminate.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Disable-CsUser in locale: RTCUniversalUserAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) 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 "Disable-CsUser"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
UserIDParameter |
Indica l'identità dell'account utente da disabilitare. Le identità utente possono essere specificate con uno dei quattro formati riportati di seguito: 1) l'indirizzo SIP dell'utente; 2) l'UPN (Universal Principal Name) dell'utente; 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). L'account utente può essere referenziati anche utilizzando il nome distinto in Active Directory. È possibile utilizzare il carattere jolly asterisco (*) quando si utilizza il nome visualizzato come identità utente. Ad esempio, l'identità "* Smith" restituisce tutti gli utenti il cui nome visualizzato termina con il valore stringa " Smith". |
DomainController |
Facoltativo |
Stringa |
Consente la connessione al controller di dominio specificato per disabilitare un account utente. Per la connessione a uno specifico controller di dominio, includere il parametro DomainController seguito dal nome computer (ad esempio atl-cs-001) o dal suo nome di dominio completo (ad esempio atl-cs-001.litwareinc.com). |
PassThru |
Facoltativo |
Parametro opzionale |
Consente di passare attraverso la pipeline un oggetto utente che rappresenta l'account utente da disabilitare. Per impostazione predefinita, il cmdlet Disable-CsUser non passa alcun oggetto attraverso la pipeline. |
Confirm |
Facoltativo |
Parametro opzionale |
Viene visualizzata una richiesta di conferma prima di eseguire il comando. |
WhatIf |
Facoltativo |
Parametro opzionale |
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente. |
Tipi di input
Stringa oppure oggetto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Disable-CsUser accetta l'input da pipeline di un valore stringa che rappresenta l'identità di un account utente abilitato per Lync Server. Il cmdlet accetta inoltre l'input da pipeline di istanze dell'oggetto utente Active Directory.
Tipi restituiti
Disable-CsUser non restituisce alcun oggetto o valore. In realtà il cmdlet configura istanze dell'oggetto Microsoft.Rtc.Management.ADConnect.Schema.ADUser.
Esempio
-------------------------- Esempio 1 --------------------------
Disable-CsUser -Identity "Ken Myer"
Con l'esempio precedente viene disabilitato l'account Lync Server per l'utente Davide Garghentini. In questo esempio viene utilizzato il nome visualizzato dell'utente per indicarne l'identità.
-------------------------- Esempio 2 --------------------------
Get-CsUser -LDAPFilter "Department=Finance" | Disable-CsUser
Con l'esempio 2 gli account Lync Server di tutti gli utenti del reparto Finance vengono disabilitati. Per eseguire questa operazione, il comando utilizza per prima cosa il cmdlet Get-CsUser e il parametro LDAPFilter per restituire una raccolta di tutti gli utenti che appartengono al reparto Finance. La raccolta viene quindi inviata tramite pipe a Disable-CsUser, che disabilita ogni account nella raccolta.
-------------------------- Esempio 3 --------------------------
Get-CsUser -UnassignedUser | Disable-CsUser
Con l'esempio precedente vengono disabilitati tutti gli account utente che attualmente non sono assegnati a un pool di registrazione. A tal fine viene chiamato il cmdlet Get-CsUser con il parametro UnassignedUser. Questo parametro limita i dati restituiti agli utenti che dispongono di account utente validi ma che non sono assegnati a un pool di registrazione. La raccolta viene quindi inviata tramite pipe a Disable-CsUser, che disabilita ogni account nella raccolta.