Compartilhar via

Set-SCOMRunAsDistribution

  • Referência
Módulo:
OperationsManager

Define a política de distribuição de uma conta Executar como para o Operations Manager.

Sintaxe

Set-SCOMRunAsDistribution
   [-RunAsAccount] <SecureData>
   [-LessSecure]
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMRunAsDistribution
   [-RunAsAccount] <SecureData>
   [-MoreSecure]
   [-SecureDistribution <Object[]>]
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMRunAsDistribution
   [-RunAsAccount] <SecureData>
   -Security <String>
   [-SecureDistribution <Object[]>]
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-SCOMRunAsDistribution define a política de distribuição de uma conta Executar como para o System Center – Operations Manager. As políticas de distribuição determinam quais computadores recebem uma credencial para uma conta Executar como. Por padrão, novas contas têm a distribuição mais segura sem sistemas aprovados.

Exemplos

Exemplo 1: Especificar uma distribuição menos segura

PS C:\>Get-SCOMRunAsAccount -Name "Contoso\LowPriv" | Set-SCOMRunAsDistribution -LessSecure

Esse comando define a conta Contoso\LowPriv para uma distribuição menos segura, de modo que o Operations Manager distribua a credencial automaticamente para todos os computadores gerenciados. O comando usa o cmdlet Get-SCOMRunAsAccount para obter a conta especificada e a passa para o cmdlet Set-SCOMRunAsDistribution usando o operador de pipeline. O comando especifica o parâmetro LessSecure.

Exemplo 2: Especificar uma distribuição mais segura sem sistemas aprovados

PS C:\>Get-SCOMRunAsAccount -Name "Contoso\LowPriv" | Set-SCOMRunAsDistribution -MoreSecure

Esse comando define a conta Contoso\LowPriv para uma distribuição mais segura, sem sistemas aprovados. O comando usa o cmdlet Get-SCOMRunAsAccount para obter a conta especificada e a passa para o cmdlet Set-SCOMRunAsDistribution usando o operador de pipeline. O comando especifica o parâmetro MoreSecure.

Exemplo 3: especificar uma distribuição mais segura para uma coleção

PS C:\>$Distribution = (Get-SCOMAgent -Name "*.contoso.com") + (Get-SCOMManagementServer) + (Get-SCOMResourcePool -DisplayName "Contoso Monitoring Pool")
PS C:\> Get-SCOMRunAsAccount "Contoso\LowPriv" | Set-SCOMRunAsDistribution -MoreSecure -SecureDistribution $Distribution

Este exemplo define a conta Contoso\LowPriv para uma distribuição mais segura para uma coleção de pools, agentes e servidores, de modo que somente pools, agentes e servidores especificados obtenham a distribuição.

O primeiro comando obtém os pools, os agentes e os servidores para receber uma distribuição mais segura e armazená-los na variável $Distribution.

O segundo comando obtém pools, agentes e servidores que têm distribuição menos segura e os passa para o cmdlet Set-SCOMRunAsDistribution usando o operador de pipeline. Esse cmdlet atribui a eles uma distribuição mais segura.

Exemplo 4: Especificar uma distribuição menos segura para uma nova conta Executar como

PS C:\>Add-SCOMRunAsAccount -Windows -Name "NewAccount" -Credential (Get-Credential) | Set-SCOMRunAsDistribution -MoreSecure -SecureDistribution (Get-SCOMAgent)

Esse comando cria uma conta Executar como para Windows e a aprova para distribuição para todos os agentes. O comando usa o cmdlet Add-SCOMRunAsAccount para adicionar a conta NewAccount com a credencial que o cmdlet get-credential cria. Em seguida, ele passa o resultado para o cmdlet Set-SCOMRunAsDistribution do usando o operador de pipeline.

Exemplo 5: Copiar uma política de distribuição mais segura para uma conta diferente

PS C:\>$MonitoringAcct = Get-SCOMRunAsAccount "Contoso\Monitoring"
PS C:\> Get-SCOMRunAsAccount "Contoso\Administrator" | Get-SCOMRunAsDistribution | Set-SCOMRunAsDistribution -RunAsAccount $MonitoringAccount

Este exemplo copia a política de distribuição segura da conta Contoso\Administrator para a conta Contoso\Monitoring.

O primeiro comando usa o cmdlet Get-SCOMRunAsAccount para obter a conta Contoso\Monitoring e armazená-la na variável $MonitoringAcct.

O segundo comando usa o cmdlet Get-SCOMRunAsAccount para obter a conta Contoso\Administrator e passá-la para o cmdlet Get-SCOMRunAsDistribution usando o operador de pipeline. O comando passa o resultado para o cmdlet Set-SCOMRunAsDistribution para copiar o resultado para a conta Contoso\Monitoring.

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 serviço de Acesso a Dados do System Center deve ser iniciado no computador. Se você não especificar um computador, o cmdlet usará o computador para a conexão do grupo de gerenciamento atual.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Credential

Especifica a conta de usuário na qual a conexão do grupo de gerenciamento é executada. Especifique um objeto PSCredential, como um que o cmdlet Get-Credential retorna para esse parâmetro. Para obter mais informações sobre objetos de credencial, 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.

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LessSecure

Indica que o Operations Manager distribui a credencial automaticamente para todos os computadores gerenciados.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MoreSecure

Indica que o Operations Manager distribui a credencial somente para sistemas que o parâmetro SecureDistribution especifica.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsAccount

Especifica uma matriz de objetos SecureData que representam contas Executar como. Para obter um objeto SecureData, use o cmdlet Get-SCOMRunAsAccount . Essa conta não pode fazer parte de um perfil Executar como.

Tipo:SecureData
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SCSession

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

Se esse parâmetro não for especificado, 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.

Tipo:Connection[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SecureDistribution

Especifica uma matriz de objetos que representam sistemas autorizados pelo cmdlet para distribuição.

Essa lista de parâmetros pode conter apenas os seguintes tipos de itens:

  • Agentes. Objetos que o cmdlet Get-SCOMAgent retorna. O cmdlet autoriza essa conta ao agente para distribuição.
  • Servidores de gerenciamento. Objetos que o cmdlet Get-SCOMManagementServer retorna. O cmdlet autoriza essa conta ao agente para distribuição.
  • Piscinas. Objetos que o cmdlet Get-SCOMResourcePool retorna. O cmdlet autoriza essa conta ao agente para distribuição.
  • Instâncias do serviço de integridade. Objetos que o cmdlet Get-SCOMClassInstance retorna e que têm um tipo gerenciado de HealthService. O cmdlet autoriza esse serviço de integridade ao agente para distribuição.

Passar a saída do cmdlet Get-SCOMRunAsDistribution como entrada para Set-SCOMRunAsDistribution usando o operador de pipeline preenche automaticamente esse parâmetro.

Tipo:Object[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Security

Especifica o nível de segurança. Os valores aceitáveis para este parâmetro são:

  • MoreSecure
  • LessSecure

Passar a saída do cmdlet Get-SCOMRunAsDistribution como entrada para Set-SCOMRunAsDistribution usando o operador de pipeline preenche automaticamente esse parâmetro.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False