Sdílet prostřednictvím

Set-SCOMUserRole

  • Reference
Modul:
OperationsManager

Nakonfiguruje roli uživatele operations manageru.

Syntaxe

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

Rutina Set-SCOMUserRole konfiguruje roli uživatele nástroje System Center – Operations Manager. Role uživatele obsahuje dvě funkce:

  • Profil. Definuje kolekci operací, ke kterým má role uživatele přístup.
  • Rozsah. Definuje hranice pro operace profilu; například úkoly a skupiny.

Tuto rutinu můžete použít k aktualizaci seznamu uživatelů nebo oboru role uživatele.

Příklady

Příklad 1: Udělení přístupu role uživatele ke všem úkolům

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

Tento příklad ukazuje, jak aktualizovat roli uživatele, aby jí udělil přístup ke všem úkolům.

První příkaz získá objekt role uživatele s názvem Contoso Operators a uloží objekt do proměnné $Role.

Druhý příkaz pomocí operátoru kanálu předává roli uživatele uloženou v proměnné $Role rutině Set-SCOMUserRole. Tato rutina udělí roli uživatele přístup ke všem úkolům a vrátí aktualizovaný objekt role uživatele. Příkaz pak předá aktualizovaný objekt Set-SCOMUserRole pomocí operátoru kanálu, který schválí roli pro všechny skupiny.

Příklad 2: Udělení přístupu role uživatele ke konkrétním úkolům

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

Tento příklad ukazuje, jak aktualizovat roli uživatele tak, aby mu udělil přístup ke konkrétním úkolům.

První příkaz získá objekt role uživatele s názvem Contoso SQL Operators a uloží objekt do proměnné $Role.

Druhý příkaz získá všechny objekty úkolů s SQL v jejich názvech a uloží objekty do $NewTaskList proměnné.

Poslední příkaz pomocí operátoru kanálu předává roli uživatele uloženou v proměnné $Role do Set-SCOMUserRole, která resetuje kolekci schválených úkolů do seznamu uloženého v proměnné $NewTaskList.

Příklad 3: Přidání uživatele role uživatele

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

Tento příklad přidá uživatele do role uživatele.

První příkaz získá objekt role uživatele s názvem Contoso Read-Only Operators a uloží objekt do proměnné $Role.

Druhý příkaz pomocí operátoru kanálu předává objekt uložený v proměnné $Role do rutiny Set-SCOMUserRole, která přidá uživatele Contoso\Cesar do existujícího seznamu uživatelů pro roli.

Parametry

-AllClass

Označuje, že oprávnění, která role uživatele Autor uděluje, se rozšíří na všechny třídy.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AllGroup

Označuje, že oprávnění, která role uživatele uděluje, se vztahují na všechny skupiny.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AllTask

Označuje, že oprávnění, která role uživatele Autor, Operátor nebo Rozšířený operátor uděluje, se vztahují na všechny úkoly.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ClassScope

Určuje pole ManagementPackClass objekty, které představují třídy, ke kterým má role Autor přístup. K získání objektu ManagementPackClass použijte rutinu Get-SCOMClass.

Typ:ManagementPackClass[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-GroupScope

Určuje pole MonitoringObjectGroup objekty, které představují skupiny, ke kterým má role uživatele přístup. K získání objektu skupiny objektů monitorování použijte rutinu Get-MonitoringObjectGroup.

Pokud pro tento parametr nezadáte hodnotu, role má přístup ke všem skupinám. Pokud chcete odepřít přístup role ke všem skupinám, zadejte $Null nebo prázdné pole @().

Typ:MonitoringObjectGroup[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PassThru

Označuje, že rutina vytvoří nebo upraví objekt, který může příkaz použít v kanálu. Ve výchozím nastavení tato rutina negeneruje žádný výstup.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TaskScope

Určuje pole ManagementPackTask objekty, které představují úlohy, ke kterým má role Autor, Operátor nebo Rozšířený operátor přístup.

Pokud pro tento parametr nezadáte hodnotu, role má přístup ke všem úkolům. Pokud chcete odepřít přístup role Autor, Operátor nebo Rozšířený operátor ke všem úkolům, zadejte $Null nebo prázdné pole @().

Typ:ManagementPackTask[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-User

Určuje pole uživatelských jmen, která jsou součástí této role uživatele. Tento seznam nahrazuje všechny existující seznamy uživatelů. Pokud chcete vymazat všechny uživatele z role uživatele, zadejte $Null nebo prázdné pole @().

Typ:String[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UserRole

Určuje objekt role uživatele. Abychom získali objekt UserRole, Rutina Get-SCOMUserRole.

Typ:UserRole
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False