Set-SCOMUserRole
Configura uma função de usuário do Operations Manager.
Sintaxe
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>]
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.
- Escopo. 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 a ela acesso a todas as tarefas.
O primeiro comando obtém o objeto de função de usuário chamado Operadores da 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 . Esse 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 a ela acesso a tarefas específicas.
O primeiro comando obtém o objeto de função de usuário chamado Operadores SQL da 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 um usuário a uma função de 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 concedidas por uma função de usuário Autor se estendem a todas as classes.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FromAllClassScope
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-AllGroup
Indica que as permissões concedidas por uma função de usuário se estendem a todos os grupos.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FromAllGroupScope
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FromAllTaskScope
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ClassScope
Especifica uma matriz de objetos ManagementPackClass que representam as classes às quais uma função Autor tem acesso. Para obter um objeto ManagementPackClass , use o cmdlet Get-SCOMClass .
Propriedades do parâmetro
| Tipo: | ManagementPackClass[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FromClassScope
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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, @().
Propriedades do parâmetro
| Tipo: | MonitoringObjectGroup[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FromGroupcope
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-TaskScope
Especifica uma matriz de objetos ManagementPackTask que representam as tarefas às quais uma função de 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 à função Autor, Operador ou Operador Avançado a todas as tarefas, especifique $Null ou uma matriz vazia, @().
Propriedades do parâmetro
| Tipo: | ManagementPackTask[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FromTaskScope
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-User
Especifica uma matriz de nomes de usuário que fazem parte dessa função de usuário. Essa lista substitui qualquer lista existente de usuários. Para limpar todos os usuários de uma função de usuário, especifique $Null ou uma matriz vazia, @().
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FromUser
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-UserRole
Especifica um objeto de função de usuário. Para obter um objeto UserRole , use o cmdlet Get-SCOMUserRole .
Propriedades do parâmetro
| Tipo: | UserRole |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.