Udostępnij za pośrednictwem


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 UserRole można przekazać obiekt . Aby uzyskać rolę użytkownika, użyj polecenia cmdlet Get-SCSMUserRole.

Dane wyjściowe

None.

To polecenie cmdlet nie generuje żadnych danych wyjściowych.