Partilhar via

Install-SCOMAgent

  • Referência
Módulo:
OperationsManager

Desdobra agentes do Diretor de Operações.

Syntax

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

Description

O cmdlet Install-SCOMAgent implementa um ou mais System Center 2019 - Gestor de Operações e posteriores agentes de versão de produto utilizando a instalação de push do cliente. Nota: O parâmetro [-NoAPM] é introduzido com o Gestor de Operações do Centro de Sistema 1807 (este parâmetro não é válido com o Gestor de Operações do System Center 2019).

Exemplos

Exemplo 1: Instalar um agente num 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 num servidor e define o servidor de gestão primária para o agente.

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

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

Exemplo 2: Instalar um agente num servidor utilizando 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 leva o utilizador a introduzir credenciais e, em seguida, utiliza as credenciais para instalar um agente.

O primeiro comando solicita ao utilizador credenciais e credenciais de loja na variável $InstallAccount.

O segundo comando recebe o objeto do servidor de gestão chamado MgmtServer01.Contoso.com e armazena o objeto na variável $PrimaryMgmtServer.

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

Exemplo 3: Instale um agente nos servidores e desemote 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 utilizador credenciais e armazena as credenciais na variável $InstallAccount.

O terceiro comando solicita ao utilizador uma palavra-passe para uma conta de utilizador chamada ActionAccount no domínio Contoso, e armazena as credenciais na variável $AgentActionAccount.

O quarto comando recebe o objeto do servidor de gestão 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 utilizando as credenciais armazenadas em $InstallAccount. O comando define o servidor de gestão primária do agente para o servidor de gestão armazenado em $PrimaryMgmtServer e define a conta de ação do agente para o utilizador ActionAccount armazenado em $AgentActionAccount.

Parâmetros

-ActionAccount

Especifica um objeto PSCredential . Este parâmetro especifica as credenciais que o Gestor de Operações utiliza para executar a tarefa de implantação. Este parâmetro é obrigatório. Se especificar um valor nulo, o Gestor de Operações utiliza a conta de ação padrão do servidor de gestão para o agente.

Este parâmetro não especifica a conta de ação que o agente utiliza depois de a instalar no computador. Por predefinição, a conta de ação que o agente utiliza é definida para o Sistema Local. Pode utilizar o parâmetro AgentActionAccount para alterar a conta de ação que o agente utiliza.

Para obter um objeto PSCredential , utilize o cmdlet Get-Credential . Para mais informações, insira 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 . Este parâmetro especifica a conta de ação que o agente utiliza depois de ser instalado no computador. Por predefinição, a conta de ação que o agente utiliza é definida para o Sistema Local. Para obter um objeto PSCredential , utilize o cmdlet Get-Credential . Para mais informações, insira Get-Help Get-Credential. Pode utilizar o cmdlet Get-SCOMRunAsProfile para obter uma conta Run As que pode utilizar 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 a 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 anfitrião do Sistema de Nome de Domínio (DNS).

Type:String[]
Aliases:Name
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 de componente APM no agente. Utilize este parâmetro para saltar a instalação do componente 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 na tubagem. Por predefinição, este cmdlet não gera quaisquer dados.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrimaryManagementServer

Especifica um objeto ManagementServer . Este parâmetro especifica o servidor de gestão primária do agente. Para obter um objeto ManagementServer , utilize o cmdlet Get-SCOMManagementServer .

Type:ManagementServer
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False