Partilhar 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 de versões posteriores do produto usando a instalação por push do cliente. Nota: O parâmetro [-NoAPM] é introduzido com o System Center Operations Manager 1807 (este 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 no $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, em seguida, usa as credenciais para instalar um agente.

O primeiro comando solicita credenciais ao usuário e armazena credenciais 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 no $InstallAccount e define o servidor de gerenciamento primário do agente para o servidor de gerenciamento armazenado no $PrimaryMgmtServer.

Exemplo 3: Instalar um agente nos 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 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 no $InstallAccount. O comando define o servidor de gerenciamento primário do agente para o servidor de gerenciamento armazenado no $PrimaryMgmtServer e define a conta de ação do agente para o usuário ActionAccount armazenado no $AgentActionAccount.

Parâmetros

-ActionAccount

Especifica um objeto PSCredential. Este 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.

Este 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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AgentActionAccount

Especifica um objeto PSCredential. Este parâmetro especifica a conta de ação que o agente usa depois de 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 contas Run As que você pode usar para a conta de ação.

Tipo:PSCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DNSHostName

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

Tipo:String[]
Aliases:Name
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-NoAPM

Este é um parâmetro opcional introduzido com o System Center Operations Manager 1807 (este 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 APM no agente.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PrimaryManagementServer

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

Tipo:ManagementServer
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False