Condividi tramite

Install-SCOMAgent

  • Riferimento
Modulo:
OperationsManager

Distribuisce gli agenti di Operations Manager.

Sintassi

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

Descrizione

Il cmdlet Install-SCOMAgent distribuisce uno o più agenti system Center 2019 - Operations Manager e versioni successive del prodotto usando l'installazione push client. Nota: il parametro [-NoAPM] viene introdotto con System Center Operations Manager 1807 (questo parametro non è valido con System Center 2019 Operations Manager).

Esempio

Esempio 1: Installare un agente in un server

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

In questo esempio viene installato un agente in un server e viene impostato il server di gestione primario per l'agente.

Il primo comando ottiene l'oggetto server di gestione denominato MgmtServer01.Contoso.com e archivia l'oggetto nella variabile $PrimaryMgmtServer.

Il secondo comando installa un agente in Server01.Contoso.com e imposta il server di gestione primario sul server di gestione archiviato in $PrimaryMgmtServer.

Esempio 2: Installare un agente in un server usando le credenziali dell'account azione

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

In questo esempio viene richiesto all'utente di immettere le credenziali e quindi di usare le credenziali per installare un agente.

Il primo comando richiede all'utente le credenziali e archivia le credenziali nella variabile $InstallAccount.

Il secondo comando ottiene l'oggetto server di gestione denominato MgmtServer01.Contoso.com e archivia l'oggetto nella variabile $PrimaryMgmtServer.

Il terzo comando installa un agente in Server01.Contoso.com usando le credenziali archiviate in $InstallAccount e imposta il server di gestione primario per l'agente sul server di gestione archiviato in $PrimaryMgmtServer.

Esempio 3: Installare un agente nei server e impostare l'account azione dell'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

Questo esempio installa gli agenti in tre computer e imposta l'account azione dell'agente per gli agenti.

Il primo comando archivia il nome di tre computer nella variabile $Agents.

Il secondo comando richiede all'utente le credenziali e archivia le credenziali nella variabile $InstallAccount.

Il terzo comando richiede all'utente una password per un account utente denominato ActionAccount nel dominio Contoso e archivia le credenziali nella variabile $AgentActionAccount.

Il quarto comando ottiene l'oggetto server di gestione denominato MgmtServer01.Contoso.com e archivia l'oggetto nella variabile $PrimaryMgmtServer.

Il quinto comando installa un agente nei tre computer archiviati nella variabile $Agents usando le credenziali archiviate in $InstallAccount. Il comando imposta il server di gestione primario per l'agente sul server di gestione archiviato in $PrimaryMgmtServer e imposta l'account azione dell'agente sull'utente ActionAccount archiviato in $AgentActionAccount.

Parametri

-ActionAccount

Specifica un oggetto PSCredential . Questo parametro specifica le credenziali usate da Operations Manager per eseguire l'attività di distribuzione. Si tratta di un parametro obbligatorio. Se si specifica un valore Null, Operations Manager usa l'account azione predefinito del server di gestione per l'agente.

Questo parametro non specifica l'account azione utilizzato dall'agente dopo l'installazione nel computer. Per impostazione predefinita, l'account azione usato dall'agente è impostato su Sistema locale. È possibile usare il parametro AgentActionAccount per modificare l'account azione usato dall'agente.

Per ottenere un oggetto PSCredential , usare il cmdlet Get-Credential . Per altre informazioni, digitare Get-Help Get-Credential.

Tipo:PSCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AgentActionAccount

Specifica un oggetto PSCredential . Questo parametro specifica l'account azione usato dall'agente dopo l'installazione nel computer. Per impostazione predefinita, l'account azione usato dall'agente è impostato su Sistema locale. Per ottenere un oggetto PSCredential , usare il cmdlet Get-Credential . Per altre informazioni, digitare Get-Help Get-Credential. È possibile usare il cmdlet Get-SCOMRunAsProfile per ottenere un account RunAs che è possibile usare per l'account azione.

Tipo:PSCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DNSHostName

Specifica il nome di un host DNS (Domain Name System).

Tipo:String[]
Alias:Name
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-NoAPM

Si tratta di un parametro facoltativo introdotto con System Center Operations Manager 1807 (questo parametro non è valido con System Center 2019 Operations Manager), che consente di scegliere l'installazione del componente APM nell'agente. Usare questo parametro per ignorare l'installazione del componente APM nell'agente.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

Indica che il cmdlet crea o modifica un oggetto che un comando può usare nella pipeline. Per impostazione predefinita, questo cmdlet non genera alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PrimaryManagementServer

Specifica un oggetto ManagementServer di . Questo parametro specifica il server di gestione primario per l'agente. Per ottenere un oggetto ManagementServer, utilizzare il cmdlet Get-SCOMManagementServer .

Tipo:ManagementServer
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False