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.