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.

Sie können dieses Cmdlet verwenden, um die Benutzerliste oder den Bereich der Benutzerrolle zu aktualisieren.

Beispiele

Beispiel 1: Gewähren des Zugriffs auf alle Aufgaben einer Benutzerrolle

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

In diesem Beispiel wird gezeigt, wie Sie eine Benutzerrolle aktualisieren, um ihr Zugriff auf alle Aufgaben zu gewähren.

Der erste Befehl ruft das Benutzerrollenobjekt mit dem Namen 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 der Benutzerrolle Zugriff auf alle Aufgaben und gibt das aktualisierte Benutzerrollenobjekt zurück. Der Befehl übergibt dann das aktualisierte Objekt mithilfe des Pipelineoperators, der die Rolle für alle Gruppen genehmigt, an Set-SCOMUserRole .

Beispiel 2: Gewähren des Zugriffs auf bestimmte Aufgaben für eine Benutzerrolle

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 Sie eine Benutzerrolle aktualisieren, um ihr Zugriff auf bestimmte Aufgaben zu gewähren.

Der erste Befehl ruft das Benutzerrollenobjekt mit dem Namen Contoso SQL Operators ab und speichert das Objekt in der $Role Variablen.

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-SCOMUserRole zu übergeben. Dadurch wird die Sammlung genehmigter Aufgaben auf die in der $NewTaskList-Variable gespeicherte Liste zurückgesetzt.

Beispiel 3: Hinzufügen einer Benutzerrolle für einen Benutzer

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 mit dem Namen Contoso Read-Only Operators ab und speichert das Objekt in der variablen $Role.

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 der vorhandenen Liste der Benutzer für die Rolle hinzufügt.

Parameter

-AllClass

Gibt an, dass die Berechtigungen, die eine Benutzerrolle Autor gewährt, auf alle Klassen ausgedehnt werden.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AllGroup

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AllTask

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ClassScope

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

Type:ManagementPackClass[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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. Geben Sie $Null oder ein leeres Array @() an, um der Rolle den Zugriff auf alle Gruppen zu verweigern.

Type:MonitoringObjectGroup[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TaskScope

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

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

Type:ManagementPackTask[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-User

Gibt ein Array von Benutzernamen an, die Teil dieser Benutzerrolle sind. Diese Liste ersetzt alle vorhandenen Benutzerlisten. Geben Sie $Null oder ein leeres Array @() an, um alle Benutzer aus einer Benutzerrolle zu löschen.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-UserRole

Gibt ein Benutzerrollenobjekt an. Um ein UserRole-Objekt zu erhalten, verwenden Sie das Cmdlet Get-SCOMUserRole .

Type:UserRole
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False