Set-SCOMUserRole

Module:

OperationsManager

Hiermee configureert u een Operations Manager-gebruikersrol.

Syntaxis

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>]

Description

De cmdlet Set-SCOMUserRole configureert een System Center - Operations Manager-gebruikersrol. Een gebruikersrol bevat twee functies:

• Profiel. Hiermee definieert u de verzameling bewerkingen waartoe de gebruikersrol toegang heeft.
• Draagwijdte. Definieert de grenzen voor profielbewerkingen; Bijvoorbeeld taken en groepen.

U kunt deze cmdlet gebruiken om de gebruikerslijst of het bereik van de gebruikersrol bij te werken.

Voorbeelden

Voorbeeld 1: Een gebruikersrol toegang verlenen tot alle taken

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

In dit voorbeeld ziet u hoe u een gebruikersrol bijwerkt om deze toegang te verlenen tot alle taken.

Met de eerste opdracht wordt het gebruikersrolobject met de naam Contoso Operators opgehaald en wordt het object opgeslagen in de $Role variabele.

De tweede opdracht maakt gebruik van de pijplijnoperator om de gebruikersrol die is opgeslagen in de $Role variabele door te geven aan de cmdlet Set-SCOMUserRole. Deze cmdlet verleent de gebruikersrol toegang tot alle taken en retourneert het bijgewerkte object van de gebruikersrol. De opdracht geeft vervolgens het bijgewerkte object door aan Set-SCOMUserRole met behulp van de pijplijnoperator, die de rol voor alle groepen goedkeurt.

Voorbeeld 2: Een gebruikersrol toegang verlenen tot specifieke taken

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

In dit voorbeeld ziet u hoe u een gebruikersrol bijwerkt om deze toegang te verlenen tot specifieke taken.

Met de eerste opdracht wordt het gebruikersrolobject met de naam Contoso SQL Operators opgehaald en wordt het object opgeslagen in de $Role variabele.

Met de tweede opdracht worden alle taakobjecten met SQL opgehaald in hun namen en worden de objecten opgeslagen in de $NewTaskList variabele.

De laatste opdracht maakt gebruik van de pijplijnoperator om de gebruikersrol die is opgeslagen in de $Role variabele door te geven aan Set-SCOMUserRole, waarmee de verzameling goedgekeurde taken opnieuw wordt ingesteld op de lijst die is opgeslagen in de $NewTaskList variabele.

Voorbeeld 3: Een gebruiker een gebruikersrol toevoegen

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

In dit voorbeeld wordt een gebruiker toegevoegd aan een gebruikersrol.

Met de eerste opdracht wordt het gebruikersrolobject met de naam Contoso Read-Only Operators opgehaald en wordt het object opgeslagen in de $Role variabele.

De tweede opdracht maakt gebruik van de pijplijnoperator om het object dat is opgeslagen in de $Role variabele door te geven aan de cmdlet Set-SCOMUserRole, waarmee de gebruiker Contoso\Cé wordt toegevoegd aan de bestaande lijst met gebruikers voor de rol.

Parameters

-AllClass

Geeft aan dat de machtigingen die een gebruikersrol Auteur verleent, worden uitgebreid naar alle klassen.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-AllGroup

Geeft aan dat de machtigingen die een gebruikersrol verleent, worden uitgebreid naar alle groepen.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-AllTask

Geeft aan dat de machtigingen die de gebruikersrol Auteur, Operator of Advanced Operator verleent, worden uitgebreid naar alle taken.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ClassScope

Hiermee geeft u een matrix van ManagementPackClass objecten die de klassen vertegenwoordigen waartoe een auteurrol toegang heeft. Als u een ManagementPackClass-object wilt verkrijgen, gebruikt u de cmdlet Get-SCOMClass.

Type:	ManagementPackClass[]
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliassen:	cf
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-GroupScope

Hiermee geeft u een matrix van MonitoringObjectGroup objecten die de groepen vertegenwoordigen waartoe een gebruikersrol toegang heeft. Als u een object voor de bewakingsobjectgroep wilt verkrijgen, gebruikt u de cmdlet Get-MonitoringObjectGroup.

Als u geen waarde voor deze parameter opgeeft, heeft de rol toegang tot alle groepen. Als u de roltoegang tot alle groepen wilt weigeren, geeft u $Null of een lege matrix op, @().

Type:	MonitoringObjectGroup[]
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-PassThru

Geeft aan dat de cmdlet een object maakt of wijzigt dat een opdracht in de pijplijn kan gebruiken. Deze cmdlet genereert standaard geen uitvoer.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-TaskScope

Hiermee geeft u een matrix van ManagementPackTask objecten die de taken vertegenwoordigen waartoe een rol Auteur, Operator of Geavanceerde operator toegang heeft.

Als u geen waarde voor deze parameter opgeeft, heeft de rol toegang tot alle taken. Als u de rol Auteur, Operator of Geavanceerde operator voor alle taken wilt weigeren, geeft u $Null of een lege matrix op, @().

Type:	ManagementPackTask[]
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-User

Hiermee geeft u een matrix van gebruikersnamen die deel uitmaken van deze gebruikersrol. Deze lijst vervangt een bestaande lijst met gebruikers. Als u alle gebruikers uit een gebruikersrol wilt wissen, geeft u $Null of een lege matrix op, @().

Type:	String[]
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-UserRole

Hiermee geeft u een gebruikersrolobject. Als u een UserRole--object wilt verkrijgen, is de cmdlet Get-SCOMUserRole.

Type:	UserRole
Position:	1
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliassen:	wi
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Verwante koppelingen

• Add-SCOMUserRole
• Get-SCOMUserRole
• Get-SCClass