Delen via

Update-SCSMUserRole

  • Referentie
Module:
System.Center.Service.Manager

Hiermee stelt u de eigenschap UserRole in voor een Service Manager-gebruiker.

Syntaxis

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

Description

De cmdlet Update-SCSMUserRole stelt de eigenschap UserRole voor een Service Manager-gebruiker in.

Voorbeelden

Voorbeeld 1: Een gebruiker toevoegen aan een gebruikersrol

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

Met de eerste opdracht wordt de gebruikersrol IncidentResolvers opgehaald met behulp van Get-SCSMUserRoleen slaat deze vervolgens op in de variabele $Role.

Met de tweede opdracht wordt een gebruiker opgehaald met behulp van de cmdlet Get-SCSMUser en wordt dat object vervolgens opgeslagen in de $User variabele.

Met de derde opdracht wordt $User toegevoegd aan de eigenschap User van $Role.

Met de laatste opdracht wordt de rol bijgewerkt zodat deze overeenkomt met de huidige waarde van $Role.

Voorbeeld 2: Een gebruiker verwijderen uit een rol

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 dit voorbeeld wordt een gebruiker uit een gebruikersrol verwijderd. Met de eerste opdracht worden beheerders weergegeven.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:System.Management.Automation.SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PassThru

Geeft aan dat deze cmdlet de gebruikersrol retourneert die wordt bijgewerkt. U kunt dit object doorgeven aan andere cmdlets.

Type:System.Management.Automation.SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UserRole

Hiermee geeft u de UserRole object waaraan de gebruiker moet worden toegevoegd.

Type:Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:System.Management.Automation.SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role

U kunt een UserRole--object doorsluisen naar de parameter UserRole. Gebruik de cmdlet Get-SCSMUserRole om een gebruikersrol te verkrijgen.

Uitvoerwaarden

None.

Met deze cmdlet wordt geen uitvoer gegenereerd.