Compartilhar via

Install-SCOMAgent

  • Referência
Módulo:
OperationsManager

Implanta agentes do Operations Manager.

Syntax

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

Description

O cmdlet Install-SCOMAgent implanta um ou mais System Center 2019 – Operations Manager e agentes de versão 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 em 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 armazena credenciais na variável $InstallAccount.

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

O terceiro comando instala um agente em 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 credenciais ao usuário 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 de 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 para 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. Este é 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á-la 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.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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ê pode usar para a conta de ação.

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

-DNSHostName

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

Type:String[]
Aliases:Name
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 escolher a instalação do componente APM no agente. Use esse parâmetro para ignorar a instalação do componente do APM no agente.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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

-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 .

Type:ManagementServer
Position:Named
Default value:None
Required:True
Accept pipeline input:False
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