Set-SCOMUserRole
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 2019 – 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; Beispielsweise Aufgaben und Gruppen.
Sie können dieses Cmdlet verwenden, um die Benutzerliste oder den Bereich der Benutzerrolle zu 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 -AllGroupIn diesem Beispiel wird gezeigt, wie Sie eine Benutzerrolle aktualisieren, 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 $Role Variablen.
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 $NewTaskListIn diesem Beispiel wird gezeigt, wie Sie eine Benutzerrolle aktualisieren, 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 $Role Variablen.
Der zweite Befehl ruft alle Aufgabenobjekte mit SQL in ihren Namen ab und speichert die Objekte in der $NewTaskList Variablen.
Der letzte Befehl verwendet den Pipelineoperator, um die in der $Role Variable gespeicherte Benutzerrolle an Set-SCOMUserRole zu übergeben, wodurch die Auflistung genehmigter Aufgaben auf die liste zurückgesetzt wird, die in der $NewTaskList Variablen gespeichert ist.
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 mit dem Namen Contoso Read-Only Operatoren 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 dem Benutzer Contoso\Cesar die vorhandene Liste der Benutzer für die Rolle hinzufügt.
Parameter
-AllClass
Gibt an, dass die Berechtigungen, die eine Autorbenutzerrolle gewährt, auf alle Klassen erweitert 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, für alle Gruppen erweitert 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 erweitert 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 zum Abrufen eines ManagementPackClass-Objekts das Cmdlet Get-SCOMClass .
| 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. Um den Rollenzugriff auf alle Gruppen zu verweigern, geben Sie $Null oder ein leeres Array ,@() an.
| 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 den Zugriff auf die Rolle "Autor", "Operator" oder "Erweiterter Operator" 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 eine vorhandene Liste der Benutzer. Um alle Benutzer aus einer Benutzerrolle zu löschen, geben Sie $Null oder ein leeres Array ,@() an.
| 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 abzurufen, verwenden wir 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 |