Dela via


Update-SCSMUserRole

Anger egenskapen UserRole för en Service Manager-användare.

Syntax

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

Description

Cmdleten Update-SCSMUserRole anger egenskapen UserRole för en Service Manager-användare.

Exempel

Exempel 1: Lägga till en användare i en användarroll

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

Det första kommandot hämtar användarrollen IncidentResolvers med hjälp av Get-SCSMUserRoleoch lagrar den sedan i variabeln $Role.

Det andra kommandot hämtar en användare med hjälp av cmdleten Get-SCSMUser och lagrar sedan objektet i variabeln $User.

Det tredje kommandot lägger till $User till egenskapen User för $Role.

Det sista kommandot uppdaterar rollen så att den matchar det aktuella värdet för $Role.

Exempel 2: Ta bort en användare från en roll

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

Det här exemplet tar bort en användare från en användarroll. Det första kommandot visar administratörer.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:System.Management.Automation.SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PassThru

Anger att den här cmdleten returnerar den användarroll som den uppdaterar. Du kan skicka det här objektet till andra cmdletar.

Typ:System.Management.Automation.SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UserRole

Anger UserRole- objekt som användaren ska läggas till i.

Typ:Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:System.Management.Automation.SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role

Du kan skicka ett UserRole--objekt till parametern UserRole. Om du vill skaffa en användarroll använder du cmdleten Get-SCSMUserRole.

Utdata

None.

Den här cmdleten genererar inga utdata.