Add-SCOMUserRole

Sintaxe

Operator (Predefinição)

Add-SCOMUserRole
    [-Name] <String>
    [[-DisplayName] <String>]
    [[-Description] <String>]
    [[-Users] <String[]>]
    [-Operator]
    [-TaskScope <ManagementPackTask[]>]
    [-GroupScope <MonitoringObjectGroup[]>]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ReadOnlyOperator

Add-SCOMUserRole
    [-Name] <String>
    [[-DisplayName] <String>]
    [[-Description] <String>]
    [[-Users] <String[]>]
    [-ReadOnlyOperator]
    [-GroupScope <MonitoringObjectGroup[]>]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Author

Add-SCOMUserRole
    [-Name] <String>
    [[-DisplayName] <String>]
    [[-Description] <String>]
    [[-Users] <String[]>]
    [-Author]
    [-ClassScope <ManagementPackClass[]>]
    [-TaskScope <ManagementPackTask[]>]
    [-GroupScope <MonitoringObjectGroup[]>]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AdvancedOperator

Add-SCOMUserRole
    [-Name] <String>
    [[-DisplayName] <String>]
    [[-Description] <String>]
    [[-Users] <String[]>]
    [-AdvancedOperator]
    [-TaskScope <ManagementPackTask[]>]
    [-GroupScope <MonitoringObjectGroup[]>]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Exemplos

Exemplo 1: Adicionar uma nova função de usuário de Operador Somente Leitura

PS C:\>Add-SCOMUserRole -Name 'Script Role' -ReadOnlyOperator

Exemplo 2: Adicionar uma nova função de usuário especificando nomes de usuário, tarefas e grupos

PS C:\>$ApprovedTasks = Get-SCOMTask -Name '*SQL*'
PS C:\> $ApprovedGroups = Get-SCOMGroup -DisplayName '*SQL*'
PS C:\> Add-SCOMUserRole -Name 'SQL Operator' -Operator -GroupScope $ApprovedGroups -TaskScope $ApprovedTasks -User 'Contoso\Katarina','Contoso\Cesar'

Parâmetros

-AdvancedOperator

Indica que a nova função é um Operador Avançado. Essa função concede aos membros a capacidade de substituir a configuração de regras e monitores para destinos específicos ou grupos de destinos dentro do escopo configurado. A função Operador Avançado também concede todas as permissões concedidas pelos perfis Operador e Operador Read-Only.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Author

Indica que a nova função é um Autor. Essa função concede aos membros a capacidade de criar, editar e excluir configurações de monitoramento que incluem tarefas, regras, monitores e modos de exibição, dentro do escopo configurado. Por conveniência, uma função Autor pode ter permissões para grupos específicos. A função Autor também concede todas as permissões nas funções Operador Avançado, Operador e Operador Read-Only.

Propriedades dos parâmetros

Conjuntos de parâmetros

-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.

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-ComputerName

Especifica uma matriz de nomes de computadores. O cmdlet estabelece conexões temporárias com grupos de gerenciamento para esses computadores. Você pode usar nomes NetBIOS, endereços IP ou FQDNs (nomes de domínio totalmente qualificados). Para especificar o computador local, digite o nome do computador, localhost ou um ponto (.).

O computador deve executar o serviço de Acesso a Dados do System Center.

Se você não especificar esse parâmetro, o padrão será o computador para a conexão atual do grupo de gerenciamento.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Credential

Especifica um objeto PSCredential para a conexão do grupo de gerenciamento. Para obter um objeto PSCredential , use o cmdlet Get-Credential. Para obter mais informações, digite Get-Help Get-Credential.

Se você especificar um computador no parâmetro ComputerName, use uma conta que tenha acesso a esse computador. O padrão é o usuário atual.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Description

Especifica uma descrição da função de usuário. Se você não especificar um valor para esse parâmetro, o cmdlet usará o valor do parâmetro DisplayName.

Propriedades dos parâmetros

Conjuntos de parâmetros

-DisplayName

Especifica o nome para exibição da função de usuário. Se esse parâmetro não aparecer, o padrão será o valor no parâmetro Name .

Propriedades dos parâmetros

Conjuntos de parâmetros

-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

Conjuntos de parâmetros

-Name

Especifica o nome da função de usuário.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Operator

Indica que a nova função é um Operador. Essa função concede aos membros a capacidade de interagir com alertas, executar tarefas e acessar exibições de acordo com seu escopo configurado. A função Operador também concede todas as permissões concedidas pelo perfil Operador Read-Only.

Propriedades dos parâmetros

Conjuntos de parâmetros

-ReadOnlyOperator

Indica que a nova função é um Operador de Read-Only. Essa função concede aos membros a capacidade de exibir alertas e acessar exibições de acordo com seu escopo configurado.

Propriedades dos parâmetros

Conjuntos de parâmetros

-SCSession

Especifica uma matriz de objetos Connection. Para obter objetos Connection, especifique o cmdlet Get-SCOMManagementGroupConnection.

Se esse parâmetro não aparecer, o cmdlet usará a conexão persistente ativa com um grupo de gerenciamento. Use o parâmetro SCSession para especificar uma conexão persistente diferente. Você pode criar uma conexão temporária com um grupo de gerenciamento usando os parâmetros ComputerName e Credential. Para obter mais informações, digite Get-Help about_OpsMgr_Connections.

Propriedades dos parâmetros

Conjuntos de parâmetros

-TaskScope

Especifica uma matriz de objetos ManagementPackTask que representam as tarefas às quais uma função Autor, Operador ou Operador Avançado tem acesso. Para obter um objeto ManagementPackTask, use o cmdlet ManagementPack.GetTask. Se esse parâmetro não aparecer, 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

Conjuntos de parâmetros

-Users

Especifica uma matriz que contém os nomes dos usuários que fazem parte da função de usuário.

Propriedades dos parâmetros

Conjuntos de parâmetros

-WhatIf

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

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Ligações Relacionadas

• Get-SCOMUserRole
• Set-SCOMUserRole