Freigeben über

Set-SCOMUserRole

  • Referenz
Modul:
OperationsManager

Konfiguriert eine Operations Manager-Benutzerrolle.

Syntax

Set-SCOMUserRole
   [-UserRole] <UserRole>
   -User <String[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMUserRole
   [-UserRole] <UserRole>
   [-AllClass]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMUserRole
   [-UserRole] <UserRole>
   -ClassScope <ManagementPackClass[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMUserRole
   [-UserRole] <UserRole>
   [-AllTask]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMUserRole
   [-UserRole] <UserRole>
   -TaskScope <ManagementPackTask[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMUserRole
   [-UserRole] <UserRole>
   [-AllGroup]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMUserRole
   [-UserRole] <UserRole>
   -GroupScope <MonitoringObjectGroup[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das cmdlet Set-SCOMUserRole konfiguriert eine System Center - Operations Manager-Benutzerrolle. Eine Benutzerrolle enthält zwei Features:

  • Profil. Definiert die Auflistung von Vorgängen, auf die die Benutzerrolle Zugriff hat.
  • Umfang. Definiert die Grenzen für Profilvorgänge; z. B. Aufgaben und Gruppen.

Mit diesem Cmdlet können Sie die Benutzerliste oder den Bereich der Benutzerrolle aktualisieren.

Beispiele

Beispiel 1: Gewähren eines Benutzerrollenzugriffs auf alle Aufgaben

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

In diesem Beispiel wird gezeigt, wie eine Benutzerrolle aktualisiert wird, um ihm Zugriff auf alle Aufgaben zu gewähren.

Der erste Befehl ruft das Benutzerrollenobjekt namens Contoso Operators ab und speichert das Objekt in der variablen $Role.

Der zweite Befehl verwendet den Pipelineoperator, um die in der $Role Variable gespeicherte Benutzerrolle an das Cmdlet Set-SCOMUserRole zu übergeben. Dieses Cmdlet gewährt dem Benutzerrollenzugriff auf alle Aufgaben und gibt das aktualisierte Benutzerrollenobjekt zurück. Anschließend übergibt der Befehl das aktualisierte Objekt an Set-SCOMUserRole mithilfe des Pipelineoperators, der die Rolle für alle Gruppen genehmigt.

Beispiel 2: Gewähren eines Benutzerrollenzugriffs auf bestimmte Aufgaben

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

In diesem Beispiel wird gezeigt, wie eine Benutzerrolle aktualisiert wird, um ihm Zugriff auf bestimmte Aufgaben zu gewähren.

Der erste Befehl ruft das Benutzerrollenobjekt namens Contoso SQL Operators ab und speichert das Objekt in der variablen $Role.

Der zweite Befehl ruft alle Aufgabenobjekte mit SQL in ihren Namen ab und speichert die Objekte in der variablen $NewTaskList.

Der letzte Befehl verwendet den Pipelineoperator, um die in der $Role Variable gespeicherte Benutzerrolle an Set-SCOMUserRolezu übergeben, wodurch die Sammlung genehmigter Aufgaben auf die in der $NewTaskList Variable gespeicherte Liste zurückgesetzt wird.

Beispiel 3: Hinzufügen eines Benutzers zu einer Benutzerrolle

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

In diesem Beispiel wird einer Benutzerrolle ein Benutzer hinzugefügt.

Der erste Befehl ruft das Benutzerrollenobjekt namens Contoso Read-Only Operators ab und speichert das Objekt in der $Role Variablen.

Der zweite Befehl verwendet den Pipelineoperator, um das in der $Role Variable gespeicherte Objekt an das Cmdlet Set-SCOMUserRole zu übergeben, das den Benutzer Contoso\Cesar zur vorhandenen Liste der Benutzer für die Rolle hinzufügt.

Parameter

-AllClass

Gibt an, dass die Berechtigungen, die eine Author-Benutzerrolle gewährt, auf alle Klassen erweitert werden.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AllGroup

Gibt an, dass die Berechtigungen, die eine Benutzerrolle gewährt, auf alle Gruppen erweitert werden.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AllTask

Gibt an, dass die Berechtigungen, die eine Benutzerrolle "Autor", "Operator" oder "Erweiterter Operator" gewährt, auf alle Aufgaben erweitert werden.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ClassScope

Gibt ein Array von ManagementPackClass- -Objekten an, die die Klassen darstellen, auf die eine Author-Rolle Zugriff hat. Um ein ManagementPackClass--Objekt abzurufen, verwenden Sie das cmdlet Get-SCOMClass.

Typ:ManagementPackClass[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-GroupScope

Gibt ein Array von MonitoringObjectGroup- -Objekten an, die die Gruppen darstellen, auf die eine Benutzerrolle Zugriff hat. Verwenden Sie zum Abrufen eines Überwachungsobjektgruppenobjekts das cmdlet Get-MonitoringObjectGroup.

Wenn Sie keinen Wert für diesen Parameter angeben, hat die Rolle Zugriff auf alle Gruppen. Um den Rollenzugriff auf alle Gruppen zu verweigern, geben Sie $Null oder ein leeres Array (@() an.

Typ:MonitoringObjectGroup[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt an, dass das Cmdlet ein Objekt erstellt oder ändert, das ein Befehl in der Pipeline verwenden kann. Standardmäßig generiert dieses Cmdlet keine Ausgabe.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TaskScope

Gibt ein Array von ManagementPackTask- -Objekten an, die die Aufgaben darstellen, auf die eine Rolle "Autor", "Operator" oder "Erweiterter Operator" zugreifen kann.

Wenn Sie keinen Wert für diesen Parameter angeben, hat die Rolle Zugriff auf alle Aufgaben. Wenn Sie den Zugriff auf die Rolle "Autor", "Operator" oder "Erweiterter Operator" auf alle Aufgaben verweigern möchten, geben Sie $Null oder ein leeres Array (@() an.

Typ:ManagementPackTask[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-User

Gibt ein Array von Benutzernamen an, die Teil dieser Benutzerrolle sind. Diese Liste ersetzt eine vorhandene Liste von Benutzern. Wenn Sie alle Benutzer aus einer Benutzerrolle löschen möchten, geben Sie $Null oder ein leeres Array (@() an.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserRole

Gibt ein Benutzerrollenobjekt an. Um ein UserRole--Objekt abzurufen, verwenden wir das Cmdlet Get-SCOMUserRole.

Typ:UserRole
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False