Update-SCSMUserRole
Ustawia właściwość UserRole dla użytkownika programu Service Manager.
Składnia
Update-SCSMUserRole
[-UserRole] <Role[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet Update-SCSMUserRole ustawia właściwość UserRole dla użytkownika programu Service Manager.
Przykłady
Przykład 1. Dodawanie użytkownika do roli użytkownika
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
Pierwsze polecenie pobiera rolę użytkownika o nazwie IncidentResolvers przy użyciu Get-SCSMUserRole, a następnie zapisuje ją w zmiennej $Role.
Drugie polecenie pobiera użytkownika przy użyciu polecenia cmdlet Get-SCSMUser, a następnie przechowuje ten obiekt w zmiennej $User.
Trzecie polecenie dołącza $User do właściwości User $Role.
Ostatnie polecenie aktualizuje rolę tak, aby odpowiadała bieżącej wartości $Role.
Przykład 2. Usuwanie użytkownika z roli
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
W tym przykładzie użytkownik zostanie usunięty z roli użytkownika. Pierwsze polecenie wyświetla administratorów.
Parametry
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Typ: | System.Management.Automation.SwitchParameter |
Aliasy: | cf |
Position: | Named |
Domyślna wartość: | False |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-PassThru
Wskazuje, że to polecenie cmdlet zwraca rolę użytkownika, którą aktualizuje. Ten obiekt można przekazać do innych poleceń cmdlet.
Typ: | System.Management.Automation.SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-UserRole
Określa obiekt UserRole, do którego ma zostać dodany użytkownik.
Typ: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role[] |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.
Typ: | System.Management.Automation.SwitchParameter |
Aliasy: | wi |
Position: | Named |
Domyślna wartość: | False |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role
Do parametru
Dane wyjściowe
None.
To polecenie cmdlet nie generuje żadnych danych wyjściowych.