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.