Set-SCOMUserRole
Configura uma função de utilizador do Operations Manager.
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
O cmdlet Set-SCOMUserRole configura uma função de utilizador do System Center – Operations Manager. Uma função de utilizador contém duas funcionalidades:
- Perfil. Define a coleção de operações às quais a função de utilizador tem acesso.
- Âmbito. Define os limites das operações de perfil; por exemplo, tarefas e grupos.
Pode utilizar este cmdlet para atualizar a lista de utilizadores ou o âmbito da função de utilizador.
Exemplos
Exemplo 1: Conceder acesso a todas as tarefas a uma função de utilizador
PS C:\>$Role = Get-SCOMUserRole -Name "Constoso Operators"
PS C:\> $Role | Set-SCOMUserRole -AllTask -PassThru | Set-SCOMUserRole -AllGroupEste exemplo mostra como atualizar uma função de utilizador para lhe conceder acesso a todas as tarefas.
O primeiro comando obtém o objeto de função de utilizador denominado Operadores Contoso e armazena o objeto na variável $Role.
O segundo comando utiliza o operador de pipeline para transmitir a função de utilizador armazenada na variável $Role para o cmdlet Set-SCOMUserRole . Este cmdlet concede à função de utilizador acesso a todas as tarefas e devolve o objeto de função de utilizador atualizado. Em seguida, o comando transmite o objeto atualizado para Set-SCOMUserRole com o operador de pipeline, que aprova a função para todos os grupos.
Exemplo 2: conceder a uma função de utilizador 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 $NewTaskListEste exemplo mostra como atualizar uma função de utilizador para lhe conceder acesso a tarefas específicas.
O primeiro comando obtém o objeto de função de utilizador denominado Operadores SQL da Contoso e armazena o objeto na variável $Role.
O segundo comando obtém todos os objetos de tarefa com SQL nos respetivos nomes e armazena os objetos na variável $NewTaskList.
O último comando utiliza o operador de pipeline para transmitir a função de utilizador armazenada na variável $Role para Set-SCOMUserRole, que repõe a coleção de tarefas aprovadas para a lista armazenada na variável $NewTaskList.
Exemplo 3: Adicionar uma função de utilizador a um utilizador
PS C:\>$Role = Get-SCOMUserRole -Name "Contoso Read-Only Operators"
PS C:\> $Role | Set-SCOMUserRole -User ($Role.Users + "Contoso\Cesar")Este exemplo adiciona um utilizador a uma função de utilizador.
O primeiro comando obtém o objeto de função de utilizador denominado Contoso Read-Only Operadores e armazena o objeto na variável $Role.
O segundo comando utiliza o operador de pipeline para transmitir o objeto armazenado na variável $Role ao cmdlet Set-SCOMUserRole , que adiciona o utilizador Contoso\Cesar à lista de utilizadores existente para a função.
Parâmetros
-AllClass
Indica que as permissões que uma função de utilizador autor concede são alargadas a todas as classes.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllGroup
Indica que as permissões concedidas por uma função de utilizador a todos os grupos.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllTask
Indica que as permissões que uma função de utilizador Autor, Operador ou Operador Avançado concede são alargadas a todas as tarefas.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 , utilize o cmdlet Get-SCOMClass .
| Type: | ManagementPackClass[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-GroupScope
Especifica uma matriz de objetos MonitoringObjectGroup que representam os grupos aos quais uma função de utilizador tem acesso. Para obter um objeto de grupo de objetos de monitorização, utilize o cmdlet Get-MonitoringObjectGroup .
Se não especificar um valor para este parâmetro, a função terá acesso a todos os grupos. Para negar o acesso à função a todos os grupos, especifique $Null ou uma matriz vazia, @().
| Type: | MonitoringObjectGroup[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Indica que o cmdlet cria ou modifica um objeto que um comando pode utilizar no pipeline. Por predefinição, este cmdlet não gera quaisquer dados.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 não especificar um valor para este 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, @().
| Type: | ManagementPackTask[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-User
Especifica uma matriz de nomes de utilizador que fazem parte desta função de utilizador. Esta lista substitui qualquer lista de utilizadores existente. Para limpar todos os utilizadores de uma função de utilizador, especifique $Null ou uma matriz vazia, @().
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRole
Especifica um objeto de função de utilizador. Para obter um objeto UserRole , temos o cmdlet Get-SCOMUserRole .
| Type: | UserRole |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |