Dela via

Set-SCOMUserRole

  • Referens
Modul:
OperationsManager

Konfigurerar en Operations Manager-användarroll.

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

Description

Cmdleten Set-SCOMUserRole konfigurerar användarrollen System Center – Operations Manager. En användarroll innehåller två funktioner:

  • Profil. Definierar den samling åtgärder som användarrollen har åtkomst till.
  • Omfattning. Definierar gränserna för profilåtgärder. till exempel uppgifter och grupper.

Du kan använda den här cmdleten för att uppdatera användarlistan eller omfånget för användarrollen.

Exempel

Exempel 1: Bevilja en användarroll åtkomst till alla uppgifter

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

Det här exemplet visar hur du uppdaterar en användarroll för att ge den åtkomst till alla aktiviteter.

Det första kommandot hämtar användarrollobjektet contosooperatorer och lagrar objektet i variabeln $Role.

Det andra kommandot använder pipelineoperatorn för att skicka användarrollen som lagras i $Role-variabeln till cmdleten Set-SCOMUserRole. Den här cmdleten ger användarrollen åtkomst till alla uppgifter och returnerar det uppdaterade användarrollobjektet. Kommandot skickar sedan det uppdaterade objektet till Set-SCOMUserRole- med hjälp av pipelineoperatorn, som godkänner rollen för alla grupper.

Exempel 2: Bevilja en användarroll åtkomst till specifika uppgifter

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

Det här exemplet visar hur du uppdaterar en användarroll för att ge den åtkomst till specifika uppgifter.

Det första kommandot hämtar användarrollobjektet contoso SQL-operatorer och lagrar objektet i variabeln $Role.

Det andra kommandot hämtar alla aktivitetsobjekt med SQL i sina namn och lagrar objekten i variabeln $NewTaskList.

Det sista kommandot använder pipelineoperatorn för att skicka användarrollen som lagras i variabeln $Role till Set-SCOMUserRole, som återställer samlingen av godkända uppgifter till listan som lagras i variabeln $NewTaskList.

Exempel 3: Lägga till en användare en användarroll

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

Det här exemplet lägger till en användare i en användarroll.

Det första kommandot hämtar användarrollobjektet contoso Read-Only operatorer och lagrar objektet i variabeln $Role.

Det andra kommandot använder pipelineoperatorn för att skicka objektet som lagras i variabeln $Role till Set-SCOMUserRole cmdlet, vilket lägger till användaren Contoso\Cesar i den befintliga listan över användare för rollen.

Parametrar

-AllClass

Anger att de behörigheter som en användarroll för författare beviljar sträcker sig till alla klasser.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AllGroup

Anger att de behörigheter som en användarroll ger utökas till alla grupper.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AllTask

Anger att de behörigheter som användarrollen Författare, Operator eller Avancerad operatör beviljar omfattar alla uppgifter.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ClassScope

Anger en matris med ManagementPackClass objekt som representerar de klasser som en redigeringsroll har åtkomst till. Om du vill hämta ett ManagementPackClass--objekt använder du cmdleten Get-SCOMClass.

Typ:ManagementPackClass[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-GroupScope

Anger en matris med MonitoringObjectGroup objekt som representerar de grupper som en användarroll har åtkomst till. Om du vill hämta ett objektgruppsobjekt för övervakning använder du cmdleten Get-MonitoringObjectGroup.

Om du inte anger något värde för den här parametern har rollen åtkomst till alla grupper. Om du vill neka rollen åtkomst till alla grupper anger du $Null eller en tom matris, @().

Typ:MonitoringObjectGroup[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PassThru

Anger att cmdleten skapar eller ändrar ett objekt som ett kommando kan använda i pipelinen. Som standard genererar den här cmdleten inga utdata.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TaskScope

Anger en matris med ManagementPackTask objekt som representerar de uppgifter som rollen Författare, Operator eller Avancerad operatör har åtkomst till.

Om du inte anger något värde för den här parametern har rollen åtkomst till alla aktiviteter. Om du vill neka rollen Författare, Operator eller Avancerad operatör åtkomst till alla aktiviteter anger du $Null eller en tom matris, @().

Typ:ManagementPackTask[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-User

Anger en matris med användarnamn som ingår i den här användarrollen. Den här listan ersätter alla befintliga användare. Om du vill rensa alla användare från en användarroll anger du $Null eller en tom matris, @().

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UserRole

Anger ett användarrollobjekt. För att hämta ett UserRole--objekt använder vi cmdleten Get-SCOMUserRole.

Typ:UserRole
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False