Compartilhar via

Install-SCOMAgent

  • Referência
Módulo:
OperationsManager

Implanta agentes do Operations Manager.

Sintaxe

Install-SCOMAgent
       -ActionAccount <PSCredential>
       [-AgentActionAccount <PSCredential>]
       -DNSHostName <String[]>
       -PrimaryManagementServer <ManagementServer>
       [-NoAPM]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

O cmdlet Install-SCOMAgent implanta um ou mais agentes do System Center 2019 – Operations Manager e versões posteriores do produto usando a instalação por push do cliente. Observação: o parâmetro [-NoAPM] é introduzido com o System Center Operations Manager 1807 (esse parâmetro não é válido com o System Center 2019 Operations Manager).

Exemplos

Exemplo 1: instalar um agente em um servidor

PS C:\>$PrimaryMgmtServer = Get-SCOMManagementServer -ComputerName "MgmtServer01.Contoso.com"
PS C:\> Install-SCOMAgent -DNSHostName "server01.contoso.com" -PrimaryManagementServer $PrimaryMgmtServer

Este exemplo instala um agente em um servidor e define o servidor de gerenciamento primário para o agente.

O primeiro comando obtém o objeto do servidor de gerenciamento chamado MgmtServer01.Contoso.com e armazena o objeto na variável $PrimaryMgmtServer.

O segundo comando instala um agente no Server01.Contoso.com e define seu servidor de gerenciamento primário para o servidor de gerenciamento armazenado em $PrimaryMgmtServer.

Exemplo 2: instalar um agente em um servidor usando as credenciais da conta de ação

PS C:\>$InstallAccount = Get-Credential
PS C:\> $PrimaryMgmtServer = Get-SCOMManagementServer -ComputerName "MgmtServer01.Contoso.com"
PS C:\> Install-SCOMAgent -DNSHostName "Server01.Contoso.com" -PrimaryManagementServer $PrimaryMgmtServer -ActionAccount $InstallAccount

Este exemplo solicita que o usuário insira credenciais e use as credenciais para instalar um agente.

O primeiro comando solicita ao usuário credenciais e credenciais de armazenamento na variável $InstallAccount.

O segundo comando obtém o objeto do servidor de gerenciamento chamado MgmtServer01.Contoso.com e armazena o objeto na variável $PrimaryMgmtServer.

O terceiro comando instala um agente no Server01.Contoso.com usando as credenciais armazenadas em $InstallAccount e define o servidor de gerenciamento primário do agente para o servidor de gerenciamento armazenado em $PrimaryMgmtServer.

Exemplo 3: instalar um agente em servidores e definir a conta de ação do agente

PS C:\>$Agents = "DC1.contoso.com","DC2.contoso.com","DC3.contoso.com"
PS C:\> $InstallAccount = Get-Credential
PS C:\> $AgentActionAccount = Get-Credential Contoso\ActionAccount
PS C:\> $PrimaryMgmtServer = Get-SCOMManagementserver -ComputerName MgmtServer01.contoso.com
PS C:\> $Install-SCOMAgent -DNSHostName $Agents -PrimaryManagementServer $PrimaryMgmtServer -ActionAccount $InstallAccount -AgentActionAccount $AgentActionAccount -Confirm

Este exemplo instala agentes em três computadores e define a conta de ação do agente para os agentes.

O primeiro comando armazena o nome de três computadores na variável $Agents.

O segundo comando solicita ao usuário credenciais e armazena as credenciais na variável $InstallAccount.

O terceiro comando solicita ao usuário uma senha para uma conta de usuário chamada ActionAccount no domínio Contoso e armazena as credenciais na variável $AgentActionAccount.

O quarto comando obtém o objeto do servidor de gerenciamento chamado MgmtServer01.Contoso.com e armazena o objeto na variável $PrimaryMgmtServer.

O quinto comando instala um agente nos três computadores armazenados na variável $Agents usando as credenciais armazenadas em $InstallAccount. O comando define o servidor de gerenciamento primário do agente para o servidor de gerenciamento armazenado em $PrimaryMgmtServer e define a conta de ação do agente como o usuário ActionAccount armazenado em $AgentActionAccount.

Parâmetros

-ActionAccount

Especifica um objeto PSCredential . Esse parâmetro especifica as credenciais que o Operations Manager usa para executar a tarefa de implantação. Esse é um parâmetro obrigatório. Se você especificar um valor nulo, o Operations Manager usará a conta de ação padrão do servidor de gerenciamento para o agente.

Esse parâmetro não especifica a conta de ação que o agente usa depois de instalá-lo no computador. Por padrão, a conta de ação que o agente usa é definida como Sistema Local. Você pode usar o parâmetro AgentActionAccount para alterar a conta de ação que o agente usa.

Para obter um objeto PSCredential, use o cmdlet Get-Credential. Para obter mais informações, digite Get-Help Get-Credential.

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

-AgentActionAccount

Especifica um objeto PSCredential . Esse parâmetro especifica a conta de ação que o agente usa depois que ele é instalado no computador. Por padrão, a conta de ação que o agente usa é definida como Sistema Local. Para obter um objeto PSCredential, use o cmdlet Get-Credential. Para obter mais informações, digite Get-Help Get-Credential. Você pode usar o cmdlet Get-SCOMRunAsProfile para obter uma conta Executar como que você possa usar para a conta de ação.

Tipo:PSCredential
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

-DNSHostName

Especifica o nome de um host DNS (Sistema de Nomes de Domínio).

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

-NoAPM

Esse é um parâmetro opcional introduzido com o System Center Operations Manager 1807 (esse parâmetro não é válido com o System Center 2019 Operations Manager), que permite que você escolha a instalação do componente do APM no agente. Use esse parâmetro para ignorar a instalação do componente do APM no agente.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
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

-PrimaryManagementServer

Especifica um objeto ManagementServer. Esse parâmetro especifica o servidor de gerenciamento primário para o agente. Para obter um objeto ManagementServer, use o cmdlet Get-SCOMManagementServer.

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