Set-SCOMRunAsDistribution
Define a política de distribuição de uma conta Executar como para o Operations Manager.
Syntax
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 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 apenas pools, agentes e servidores especificados obtenham a distribuição.
O primeiro comando obtém os pools, agentes e servidores para receber distribuição mais segura e os armazena 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 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 a passa 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita 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 |
-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.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LessSecure
Indica que o Operations Manager distribui a credencial automaticamente para todos os computadores gerenciados.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MoreSecure
Indica que o Operations Manager distribui a credencial somente para sistemas especificados pelo parâmetro SecureDistribution .
Type: | SwitchParameter |
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 usar no pipeline. Por padrão, este cmdlet não gera saída.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SecureData |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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
.
Type: | Connection[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecureDistribution
Especifica uma matriz de objetos que representam sistemas que o cmdlet autoriza 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.
- Pools. 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.
Type: | Object[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Security
Especifica o nível de segurança. Os valores aceitáveis para esse 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |