Partilhar via

Set-SCOMUserRole

  • Referência
Módulo:
OperationsManager

Configura uma função de usuário do Operations Manager.

Sintaxe

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

O cmdlet Set-SCOMUserRole configura uma função de usuário do System Center - Operations Manager. Uma função de usuário contém dois recursos:

  • Perfil. Define a coleção de operações às quais a função de usuário tem acesso.
  • Âmbito de aplicação. Define os limites para operações de perfil; por exemplo, tarefas e grupos.

Você pode usar esse cmdlet para atualizar a lista de usuários ou o escopo da função de usuário.

Exemplos

Exemplo 1: Conceder a uma função de usuário acesso a todas as tarefas

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

Este exemplo mostra como atualizar uma função de usuário para conceder-lhe acesso a todas as tarefas.

O primeiro comando obtém o objeto de função de usuário chamado Operadores Contoso e armazena o objeto na variável $Role.

O segundo comando usa o operador de pipeline para passar a função de usuário armazenada na variável $Role para o cmdlet Set-SCOMUserRole. Este cmdlet concede à função de usuário acesso a todas as tarefas e retorna o objeto de função de usuário atualizado. Em seguida, o comando passa o objeto atualizado para Set-SCOMUserRole usando o operador de pipeline, que aprova a função para todos os grupos.

Exemplo 2: Conceder a uma função de usuário acesso a tarefas específicas

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

Este exemplo mostra como atualizar uma função de usuário para conceder-lhe acesso a tarefas específicas.

O primeiro comando obtém o objeto de função de usuário chamado Operadores SQL Contoso e armazena o objeto na variável $Role.

O segundo comando obtém todos os objetos de tarefa com SQL em seus nomes e armazena os objetos na variável $NewTaskList.

O último comando usa o operador de pipeline para passar a função de usuário armazenada na variável $Role para Set-SCOMUserRole, que redefine a coleção de tarefas aprovadas para a lista armazenada na variável $NewTaskList.

Exemplo 3: Adicionar uma função de usuário a um usuário

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

Este exemplo adiciona um usuário a uma função de usuário.

O primeiro comando obtém o objeto de função de usuário chamado Contoso Read-Only Operators e armazena o objeto na variável $Role.

O segundo comando usa o operador de pipeline para passar o objeto armazenado na variável $Role para o cmdlet Set-SCOMUserRole, que adiciona o usuário Contoso\Cesar à lista existente de usuários para a função.

Parâmetros

-AllClass

Indica que as permissões que uma função de usuário Autor concede se estendem a todas as classes.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AllGroup

Indica que as permissões concedidas por uma função de usuário se estendem a todos os grupos.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AllTask

Indica que as permissões concedidas por uma função de usuário Autor, Operador ou Operador Avançado se estendem a todas as tarefas.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ClassScope

Especifica uma matriz de objetos ManagementPackClass que representam as classes às quais uma função Author tem acesso. Para obter um objeto ManagementPackClass, use o cmdlet Get-SCOMClass.

Tipo:ManagementPackClass[]
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-GroupScope

Especifica uma matriz de objetos MonitoringObjectGroup que representam os grupos aos quais uma função de usuário tem acesso. Para obter um objeto de grupo de objetos de monitoramento, use o cmdlet Get-MonitoringObjectGroup.

Se você não especificar um valor para esse parâmetro, a função terá acesso a todos os grupos. Para negar o acesso da função a todos os grupos, especifique $Null ou uma matriz vazia, @().

Tipo:MonitoringObjectGroup[]
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PassThru

Indica que o cmdlet cria ou modifica um objeto que um comando pode usar no pipeline. Por padrão, esse cmdlet não gera nenhuma saída.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TaskScope

Especifica uma matriz de objetos ManagementPackTask que representam as tarefas às quais uma função Autor, Operador ou Operador Avançado tem acesso.

Se você não especificar um valor para esse parâmetro, a função terá acesso a todas as tarefas. Para negar o acesso da função Autor, Operador ou Operador Avançado a todas as tarefas, especifique $Null ou uma matriz vazia, @().

Tipo:ManagementPackTask[]
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-User

Especifica uma matriz de nomes de usuário que fazem parte dessa função de usuário. Esta lista substitui qualquer lista existente de utilizadores. Para limpar todos os usuários de uma função de usuário, especifique $Null ou uma matriz vazia, @().

Tipo:String[]
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-UserRole

Especifica um objeto de função de usuário. Para obter um objeto UserRole, nós o cmdlet Get-SCOMUserRole.

Tipo:UserRole
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False