Partilhar via

Set-SCOMRunAsProfile

  • Referência
Módulo:
OperationsManager

Adiciona contas Run As ou as remove de um perfil Run As.

Sintaxe

Set-SCOMRunAsProfile
   [-Account] <SecureData[]>
   [-Profile] <ManagementPackSecureReference>
   [-Action] <RunAsProfileAccountsAction>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMRunAsProfile
   [-Class] <ManagementPackClass[]>
   [-Account] <SecureData[]>
   [-Profile] <ManagementPackSecureReference>
   [-Action] <RunAsProfileAccountsAction>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMRunAsProfile
   [-Instance] <MonitoringObject[]>
   [-Account] <SecureData[]>
   [-Profile] <ManagementPackSecureReference>
   [-Action] <RunAsProfileAccountsAction>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMRunAsProfile
   [-Group] <MonitoringObject[]>
   [-Account] <SecureData[]>
   [-Profile] <ManagementPackSecureReference>
   [-Action] <RunAsProfileAccountsAction>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-SCOMRunAsProfile adiciona contas Run As ou remove contas Run As de um perfil Run As.

Exemplos

Exemplo 1: Adicionar uma conta Run As a um perfil Run As especificando um nome de conta

PS C:\>$Profile = Get-RunAsProfile -DisplayName "Privileged Monitoring Account"
PS C:\> $Account = Get-SCOMRunAsAccount -Name "High Privileged Account"
PS C:\> Set-SCOMRunAsProfile -Action "Add" -Profile $Profile -Account $Account

Este exemplo adiciona uma conta Run As a um perfil Run As especificando um nome de conta.

O primeiro comando obtém o perfil Run As que tem o nome de exibição Conta de Monitoramento Privilegiado e o armazena na variável $Profile.

O segundo comando obtém a conta Run As chamada High Privileged Account e a armazena na variável $Account.

O terceiro comando adiciona a conta armazenada na variável $Account ao perfil Run As armazenado na variável $Profile e configura a conta Run As. Como o comando não especifica uma classe, grupo ou objeto, ele configura a conta Run As para gerenciar todos os objetos de destino.

Exemplo 2: Adicionar uma conta Run As a um perfil Run As especificando um caminho

PS C:\>$Profile = Get-SCOMRunAsProfile -DisplayName "SQL Server Monitoring Account"
PS C:\> $Account = Get-SCOMrunAsAccount -Name "Contoso\SQLAuth"
PS C:\> $Group = Get-SCOMGroup -DisplayName "Contoso financial SQL Servers"
PS C:\> Set-SCOMRunAsProfile -Action "Add" -Profile $Profile -Account $Account -Group $Group

Este exemplo adiciona uma conta Run As a um perfil Run As especificando um nome de caminho.

O primeiro comando obtém o perfil Run As chamado Conta de Monitoramento do SQL Server e o armazena na variável $Profile.

O segundo comando obtém a conta Run As chamada Contoso\SQLAuth e a armazena na variável $Account.

O terceiro comando obtém o grupo chamado Contoso financial SQL Servers e o armazena na variável $Group.

O quarto comando adiciona a conta armazenada na variável $Account ao perfil Run As armazenado na variável $Profile e configura a conta Run As para gerenciar o grupo armazenado na variável $Group.

Exemplo 3: Adicionar uma conta Run As a um perfil Run As especificando um objeto

PS C:\>$Profile = Get-SCOMRunAsProfile -DisplayName "SQL Server Monitoring Account"
PS C:\> $Account = Get-SCOMrunAsAccount -Name "Contoso\SQLAuth"
PS C:\> $Group = Get-SCOMGroup -DisplayName "Contoso financial SQL Servers"
PS C:\> Set-SCOMRunAsProfile -Action "Add" -Profile $Profile -Account $Account -Group $Group

Este exemplo adiciona uma conta Run As a um perfil Run As especificando um objeto account.

O primeiro comando obtém o objeto de perfil Run As que tem o nome de exibição Conta de Monitoramento do SQL Server e armazena o objeto na variável $Profile.

O segundo comando obtém o objeto de conta Run As chamado Contoso\SQLAuth e armazena o objeto na variável $Account.

O terceiro comando obtém o objeto de grupo que tem o nome de exibição Contoso financial SQL Servers e armazena o objeto na variável $Group.

O último comando adiciona a conta e o grupo armazenados em $Account e $Group ao perfil Conta de Monitoramento do SQL Server, que é armazenado na variável $Profile.

Parâmetros

-Account

Especifica uma matriz de objetos de Microsoft.EnterpriseManagement.Security.SecureData que representam contas Run As. Para obter um objeto SecureData, use o cmdlet Get-SCOMRunAsAccount.

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

-Action

Especifica a ação a ser executada para atualizar o perfil Run As. Os valores aceitáveis para este parâmetro são: Adicionar ou Remover.

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

-Class

Especifica uma matriz de objetos de ManagementPackClass que representam as classes que a conta Run As pode gerenciar. Especifique uma variável que armazene classes ou use um cmdlet como Get-SCOMClass que obtém classes.

Tipo:ManagementPackClass[]
Position:1
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

-Group

Especifica uma matriz de objetos de monitoramento que representam os grupos que a conta Run As pode gerenciar. Especifique uma variável que armazene grupos ou use um cmdlet como Get-SCOMGroup que obtém grupos.

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

-Instance

Especifica uma matriz de objetos de monitoramento que representam as instâncias de classe que a conta Run As pode gerenciar. Especifique uma variável que armazene instâncias de classe ou use um cmdlet como Get-SCOMClassInstance que obtém instâncias de classe. Este parâmetro também aceita objetos de grupo. Para obter um objeto de grupo, use o cmdlet Get-SCOMGroup.

Tipo:MonitoringObject[]
Position:1
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

-Profile

Especifica o perfil Run As a ser atualizado. Especifique uma variável que armazene um perfil Run As ou use um cmdlet como Get-SCOMRunAsProfile que obtém um perfil.

Tipo:ManagementPackSecureReference
Position:3
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