Set-SCOMRunAsDistribution
Define a política de distribuição de uma conta Run As para o Operations Manager.
Sintaxe
LessSecure
Set-SCOMRunAsDistribution
[-RunAsAccount] <SecureData>
[-LessSecure]
[-PassThru]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
MoreSecure
Set-SCOMRunAsDistribution
[-RunAsAccount] <SecureData>
[-MoreSecure]
[-SecureDistribution <Object[]>]
[-PassThru]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Security
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 Run As para o System Center - Operations Manager. As políticas de distribuição determinam quais computadores recebem uma credencial para uma conta Run As. Por padrão, as 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
Este comando define a conta Contoso\LowPriv para uma distribuição menos segura, para que o Operations Manager distribua a credencial automaticamente a 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
Este 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 como uma coleção de pools, agentes e servidores, para que apenas pools, agentes e servidores especificados obtenham a distribuição.
O primeiro comando faz com que os pools, agentes e servidores recebam uma 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 distribuição menos segura para uma nova conta Run As
PS C:\>Add-SCOMRunAsAccount -Windows -Name "NewAccount" -Credential (Get-Credential) | Set-SCOMRunAsDistribution -MoreSecure -SecureDistribution (Get-SCOMAgent)
Este comando cria uma conta Run As para Windows e aprova-a para distribuição a todos os agentes. O comando usa o cmdlet Add-SCOMRunAsAccount para adicionar a conta NewAccount com a credencial criada pelo cmdlet Get-Credential . 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 a armazena 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 atual do grupo de gerenciamento.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Credential
Especifica a conta de usuário sob a 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.
Propriedades dos parâmetros
| Tipo: | PSCredential |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-LessSecure
Indica que o Operations Manager distribui a credencial automaticamente para todos os computadores gerenciados.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
LessSecure
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-MoreSecure
Indica que o Operations Manager distribui a credencial somente para sistemas especificados pelo parâmetro SecureDistribution .
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
MoreSecure
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-RunAsAccount
Especifica uma matriz de objetos SecureData que representam contas Run As. Para obter um objeto SecureData , use o cmdlet Get-SCOMRunAsAccount . Esta conta não pode fazer parte de um perfil Run As.
Propriedades dos parâmetros
| Tipo: | SecureData |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | Connection[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-SecureDistribution
Especifica uma matriz de objetos que representam sistemas que o cmdlet autoriza para distribuição.
Esta 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.
- Gestão de servidores. 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 de serviços de saúde. 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.
Propriedades dos parâmetros
| Tipo: | Object[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
MoreSecure
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
Security
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Security
Especifica o nível de segurança. Os valores aceitáveis para este parâmetro são:
- MaisSeguro
- Menos seguro
Passar a saída do cmdlet Get-SCOMRunAsDistribution como entrada para Set-SCOMRunAsDistribution usando o operador de pipeline preenche automaticamente esse parâmetro.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Security
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.