Condividi tramite


Update-SCSMUserRole

Imposta la proprietà UserRole per un utente di Service Manager.

Sintassi

Update-SCSMUserRole
      [-UserRole] <Role[]>
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Il cmdlet Update-SCSMUserRole imposta la proprietà UserRole per un utente di Service Manager.

Esempio

Esempio 1: Aggiungere un utente a un ruolo utente

PS C:\>$Role = Get-SCSMUserRole -Name "IncidentResolvers"
PS C:\> $User = Get-SCSMUser -UserName "PattiFuller"
PS C:\> $Role.User += $User
PS C:\> Update-SCSMUserRole -Role $Role

Il primo comando ottiene il ruolo utente denominato IncidentResolvers usando Get-SCSMUserRolee quindi lo archivia nella variabile $Role.

Il secondo comando ottiene un utente usando il cmdlet Get-SCSMUser e quindi archivia tale oggetto nella variabile $User.

Il terzo comando aggiunge $User alla proprietà user di di $Role.

Il comando finale aggiorna il ruolo in modo che corrisponda al valore corrente di $Role.

Esempio 2: Rimuovere un utente da un ruolo

PS C:\>Get-SCSMUserRole -Name "Administrators"
WOODGROVE\Administrator
WOODGROVE\Domain Admins


The second command assigns the user role previously displayed to the $Role variable. 
PS C:\>$Role = Get-SCSMUserRole -Name "Administrators"

The third command assigns the first user role to the **User** property of $Role. This command that property, removing all except the specified user. 
PS C:\>$Role.User = $Role.Users[0]

The final command updates the role to match the current value of $Role.
PS C:\>Update-SCSMUserRole -Role $Role

In questo esempio viene rimosso un utente da un ruolo utente. Il primo comando visualizza gli amministratori.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:System.Management.Automation.SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

Indica che questo cmdlet restituisce il ruolo utente che aggiorna. È possibile passare questo oggetto ad altri cmdlet.

Tipo:System.Management.Automation.SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UserRole

Specifica l'oggetto UserRole a cui aggiungere l'utente.

Tipo:Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:System.Management.Automation.SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role

È possibile inviare tramite pipe un oggetto UserRole al parametro UserRole . Per ottenere un ruolo utente, usare il cmdlet Get-SCSMUserRole.

Output

None.

Questo cmdlet non genera alcun output.