Udostępnij przez


Set-SCOMUserRole

Konfiguruje rolę użytkownika programu Operations Manager.

Składnia

FromUser

Set-SCOMUserRole
    [-UserRole] <UserRole>
    -User <String[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromAllClassScope

Set-SCOMUserRole
    [-UserRole] <UserRole>
    [-AllClass]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromClassScope

Set-SCOMUserRole
    [-UserRole] <UserRole>
    -ClassScope <ManagementPackClass[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromAllTaskScope

Set-SCOMUserRole
    [-UserRole] <UserRole>
    [-AllTask]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromTaskScope

Set-SCOMUserRole
    [-UserRole] <UserRole>
    -TaskScope <ManagementPackTask[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromAllGroupScope

Set-SCOMUserRole
    [-UserRole] <UserRole>
    [-AllGroup]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromGroupcope

Set-SCOMUserRole
    [-UserRole] <UserRole>
    -GroupScope <MonitoringObjectGroup[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Polecenie cmdlet Set-SCOMUserRole konfiguruje rolę użytkownika programu System Center — Operations Manager. Rola użytkownika zawiera dwie funkcje:

  • Profil. Definiuje kolekcję operacji, do których ma dostęp rola użytkownika.
  • Zakres. Definiuje granice operacji profilu; na przykład zadania i grupy.

To polecenie cmdlet służy do aktualizowania listy użytkowników lub zakresu roli użytkownika.

Przykłady

Przykład 1. Udzielanie użytkownikowi dostępu do wszystkich zadań

PS C:\>$Role = Get-SCOMUserRole -Name "Constoso Operators"
PS C:\> $Role | Set-SCOMUserRole -AllTask -PassThru | Set-SCOMUserRole -AllGroup

W tym przykładzie pokazano, jak zaktualizować rolę użytkownika w celu udzielenia jej dostępu do wszystkich zadań.

Pierwsze polecenie pobiera obiekt roli użytkownika o nazwie Operatory firmy Contoso i przechowuje obiekt w zmiennej $Role.

Drugie polecenie używa operatora potoku do przekazania roli użytkownika przechowywanej w zmiennej $Role do polecenia cmdlet Set-SCOMUserRole. To polecenie cmdlet przyznaje użytkownikowi dostęp do wszystkich zadań i zwraca zaktualizowany obiekt roli użytkownika. Następnie polecenie przekazuje zaktualizowany obiekt do Set-SCOMUserRole przy użyciu operatora potoku, który zatwierdza rolę dla wszystkich grup.

Przykład 2. Udzielanie użytkownikowi dostępu do określonych zadań

PS C:\>$Role = Get-SCOMUserRole -Name "Constoso SQL Operators"
PS C:\> $NewTaskList = Get-SCOMTask -Name "*SQL*"
PS C:\> $Role | Set-SCOMUserRole -TaskScope $NewTaskList

W tym przykładzie pokazano, jak zaktualizować rolę użytkownika w celu udzielenia mu dostępu do określonych zadań.

Pierwsze polecenie pobiera obiekt roli użytkownika o nazwie Contoso SQL Operators i przechowuje obiekt w zmiennej $Role.

Drugie polecenie pobiera wszystkie obiekty zadań z bazą danych SQL w nazwach i przechowuje obiekty w zmiennej $NewTaskList.

Ostatnie polecenie używa operatora potoku do przekazania roli użytkownika przechowywanej w zmiennej $Role, aby Set-SCOMUserRole, która resetuje kolekcję zatwierdzonych zadań do listy przechowywanej w zmiennej $NewTaskList.

Przykład 3. Dodawanie użytkownika do roli użytkownika

PS C:\>$Role = Get-SCOMUserRole -Name "Contoso Read-Only Operators"
PS C:\> $Role | Set-SCOMUserRole -User ($Role.Users + "Contoso\Cesar")

W tym przykładzie użytkownik jest dodany do roli użytkownika.

Pierwsze polecenie pobiera obiekt roli użytkownika o nazwie Contoso Read-Only Operatory i przechowuje obiekt w zmiennej $Role.

Drugie polecenie używa operatora potoku do przekazania obiektu przechowywanego w zmiennej $Role do Set-SCOMUserRole polecenia cmdlet, które dodaje użytkownika Contoso\Cesar do istniejącej listy użytkowników dla roli.

Parametry

-AllClass

Wskazuje, że uprawnienia przyznane przez rolę użytkownika Autor są rozszerzane na wszystkie klasy.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

FromAllClassScope
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-AllGroup

Wskazuje, że uprawnienia przyznane przez rolę użytkownika są rozszerzane na wszystkie grupy.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

FromAllGroupScope
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-AllTask

Wskazuje, że uprawnienia, które przyznaje rola użytkownika Autor, Operator lub Operator zaawansowany, rozciągają się na wszystkie zadania.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

FromAllTaskScope
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ClassScope

Określa tablicę obiektów ManagementPackClass reprezentujących klasy, do których ma dostęp rola Autor. Aby uzyskać obiekt ManagementPackClass, użyj polecenia cmdlet Get-SCOMClass.

Właściwości parametru

Typ:

ManagementPackClass[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

FromClassScope
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-GroupScope

Określa tablicę obiektów MonitoringObjectGroup reprezentujących grupy, do których ma dostęp rola użytkownika. Aby uzyskać obiekt grupy obiektów monitorowania, użyj polecenia cmdlet Get-MonitoringObjectGroup.

Jeśli nie określisz wartości tego parametru, rola ma dostęp do wszystkich grup. Aby odmówić dostępu roli do wszystkich grup, określ $Null lub pustą tablicę @().

Właściwości parametru

Typ:

MonitoringObjectGroup[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

FromGroupcope
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PassThru

Wskazuje, że polecenie cmdlet tworzy lub modyfikuje obiekt, którego polecenie może użyć w potoku. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-TaskScope

Określa tablicę obiektów ManagementPackTask reprezentujących zadania, do których ma dostęp rola Autor, Operator lub Operator zaawansowany.

Jeśli nie określisz wartości tego parametru, rola ma dostęp do wszystkich zadań. Aby odmówić dostępu roli Autor, Operator lub Operator zaawansowany do wszystkich zadań, określ $Null lub pustą tablicę@().

Właściwości parametru

Typ:

ManagementPackTask[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

FromTaskScope
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-User

Określa tablicę nazw użytkowników, które są częścią tej roli użytkownika. Ta lista zastępuje dowolną istniejącą listę użytkowników. Aby wyczyścić wszystkich użytkowników z roli użytkownika, określ $Null lub pustą tablicę, @().

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

FromUser
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-UserRole

Określa obiekt roli użytkownika. Aby uzyskać obiekt UserRole, get-SCOMUserRole polecenia cmdlet.

Właściwości parametru

Typ:UserRole
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:1
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.