Sdílet prostřednictvím


Update-SCSMUserRole

Nastaví vlastnost UserRole pro uživatele Service Manageru.

Syntaxe

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

Description

Rutina Update-SCSMUserRole nastaví vlastnost UserRole pro uživatele Service Manageru.

Příklady

Příklad 1: Přidání uživatele do role uživatele

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

První příkaz získá roli uživatele s názvem IncidentResolvers pomocí Get-SCSMUserRolea pak ji uloží do proměnné $Role.

Druhý příkaz získá uživatele pomocí rutiny Get-SCSMUser a pak tento objekt uloží do proměnné $User.

Třetí příkaz připojí $User k vlastnosti User $Role.

Poslední příkaz aktualizuje roli tak, aby odpovídala aktuální hodnotě $Role.

Příklad 2: Odebrání uživatele z role

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

Tento příklad odebere uživatele z role uživatele. První příkaz zobrazí správce.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:System.Management.Automation.SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PassThru

Označuje, že tato rutina vrací roli uživatele, kterou aktualizuje. Tento objekt můžete předat jiným rutinám.

Typ:System.Management.Automation.SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UserRole

Určuje UserRole objekt, do kterého chcete přidat uživatele.

Typ:Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:System.Management.Automation.SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role

Objekt UserRole můžete předvést do userRole parametru. Pokud chcete získat roli uživatele, použijte rutinu Get-SCSMUserRole.

Výstupy

None.

Tato rutina negeneruje žádný výstup.