Set-SCOMUserRole
Konfiguriert eine Operations Manager-Benutzerrolle.
Syntax
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>]
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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
FromAllClassScope
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-AllGroup
Gibt an, dass die Berechtigungen, die eine Benutzerrolle gewährt, auf alle Gruppen erweitert werden.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
FromAllGroupScope
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-AllTask
Gibt an, dass die Berechtigungen, die eine Benutzerrolle "Autor", "Operator" oder "Erweiterter Operator" gewährt, auf alle Aufgaben erweitert werden.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
FromAllTaskScope
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | ManagementPackClass[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
FromClassScope
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | MonitoringObjectGroup[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
FromGroupcope
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | ManagementPackTask[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
FromTaskScope
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
FromUser
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-UserRole
Gibt ein Benutzerrollenobjekt an. Um ein UserRole--Objekt abzurufen, verwenden wir das Cmdlet Get-SCOMUserRole.
Parametereigenschaften
| Typ: | UserRole |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.