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.
- Â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.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromAllClassScope
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-AllGroup
Indica que as permissões concedidas por uma função de usuário se estendem a todos os grupos.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromAllGroupScope
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromAllTaskScope
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-ClassScope
Especifica uma matriz de objetos ManagementPackClass que representam as classes às quais uma função Author tem acesso.
Para obter um objeto
Propriedades dos parâmetros
| Tipo: | ManagementPackClass[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromClassScope
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 dos parâmetros
| Tipo: | MonitoringObjectGroup[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromGroupcope
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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, @().
Propriedades dos parâmetros
| Tipo: | ManagementPackTask[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromTaskScope
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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, @().
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromUser
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-UserRole
Especifica um objeto de função de usuário. Para obter um objeto UserRole, nós o cmdlet Get-SCOMUserRole.
Propriedades dos parâmetros
| Tipo: | UserRole |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.