Freigeben über

Install-SCOMAgent

  • Referenz
Modul:
OperationsManager

Stellt Operations Manager-Agents bereit.

Syntax

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

Beschreibung

Das Cmdlet Install-SCOMAgent stellt eine oder mehrere System Center 2019 - Operations Manager und höher Produktversions-Agents mithilfe der Client-Pushinstallation bereit. Hinweis: [-NoAPM]-Parameter wird mit System Center Operations Manager 1807 eingeführt (dieser Parameter ist nicht gültig mit System Center 2019 Operations Manager).

Beispiele

Beispiel 1: Installieren eines Agents auf einem Server

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

In diesem Beispiel wird ein Agent auf einem Server installiert und der primäre Verwaltungsserver für den Agent festgelegt.

Der erste Befehl ruft das Verwaltungsserverobjekt namens MgmtServer01.Contoso.com ab und speichert das Objekt in der $PrimaryMgmtServer Variable.

Der zweite Befehl installiert einen Agent auf Server01.Contoso.com und legt seinen primären Verwaltungsserver auf den Verwaltungsserver fest, der in $PrimaryMgmtServer gespeichert ist.

Beispiel 2: Installieren eines Agents auf einem Server mithilfe der Anmeldeinformationen des Aktionskontos

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 diesem Beispiel wird der Benutzer aufgefordert, Anmeldeinformationen einzugeben und dann die Anmeldeinformationen zum Installieren eines Agents zu verwenden.

Der erste Befehl fordert den Benutzer auf, Anmeldeinformationen und Anmeldeinformationen in der $InstallAccount Variablen zu speichern.

Der zweite Befehl ruft das Verwaltungsserverobjekt namens MgmtServer01.Contoso.com ab und speichert das Objekt in der $PrimaryMgmtServer Variable.

Der dritte Befehl installiert einen Agent auf Server01.Contoso.com mithilfe der Anmeldeinformationen, die in $InstallAccount gespeichert sind, und legt den primären Verwaltungsserver für den Agent auf den in $PrimaryMgmtServer gespeicherten Verwaltungsserver fest.

Beispiel 3: Installieren eines Agent auf Servern und Festlegen des Agent-Aktionskontos

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

In diesem Beispiel werden Agents auf drei Computern installiert und das Agentaktionskonto für die Agents festgelegt.

Der erste Befehl speichert den Namen von drei Computern in der $Agents Variable.

Der zweite Befehl fordert den Benutzer auf, Anmeldeinformationen zu erhalten und die Anmeldeinformationen in der variablen $InstallAccount zu speichern.

Der dritte Befehl fordert den Benutzer für ein Kennwort für ein Benutzerkonto namens ActionAccount in der Contoso-Domäne auf, und speichert die Anmeldeinformationen in der $AgentActionAccount Variable.

Der vierte Befehl ruft das Verwaltungsserverobjekt namens MgmtServer01.Contoso.com ab und speichert das Objekt in der $PrimaryMgmtServer Variablen.

Der fünfte Befehl installiert einen Agent auf den drei Computern, die in der $Agents Variablen gespeichert sind, indem die Anmeldeinformationen verwendet werden, die in $InstallAccount gespeichert sind. Der Befehl legt den primären Verwaltungsserver für den Agent auf den verwaltungsserver fest, der in $PrimaryMgmtServer gespeichert ist, und legt das Agentaktionskonto auf den in $AgentActionAccount gespeicherten ActionAccount-Benutzer fest.

Parameter

-ActionAccount

Gibt ein PSCredential-Objekt an. Dieser Parameter gibt die Anmeldeinformationen an, die Operations Manager zum Ausführen der Bereitstellungsaufgabe verwendet. Dies ist ein erforderlicher Parameter. Wenn Sie einen Nullwert angeben, verwendet Operations Manager das Standardaktionskonto des Verwaltungsservers für den Agent.

Dieser Parameter gibt nicht das Aktionskonto an, das der Agent nach der Installation auf dem Computer verwendet. Standardmäßig ist das Aktionskonto, das der Agent verwendet, auf "Lokales System" festgelegt. Sie können den AgentActionAccount-Parameter verwenden, um das Aktionskonto zu ändern, das der Agent verwendet.

Verwenden Sie zum Abrufen eines PSCredential-Objekts das Get-Credential-Cmdlet. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential.

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

-AgentActionAccount

Gibt ein PSCredential-Objekt an. Dieser Parameter gibt das Aktionskonto an, das der Agent nach der Installation auf dem Computer verwendet. Standardmäßig ist das Aktionskonto, das der Agent verwendet, auf "Lokales System" festgelegt. Verwenden Sie zum Abrufen eines PSCredential-Objekts das Get-Credential-Cmdlet. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential. Sie können das Cmdlet "Get-SCOMRunAsProfile " verwenden, um ein Run As-Konto abzurufen, das Sie für das Aktionskonto verwenden können.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-DNSHostName

Gibt den Namen eines Dns-Hosts (Domain Name System) an.

Type:String[]
Aliases:Name
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoAPM

Dies ist ein optionaler Parameter, der mit System Center Operations Manager 1807 eingeführt wurde (dieser Parameter ist nicht mit System Center 2019 Operations Manager gültig), mit dem Sie die Installation der APM-Komponente im Agent auswählen können. Verwenden Sie diesen Parameter, um die Installation der APM-Komponente im Agent zu überspringen.

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

-PassThru

Gibt an, dass das Cmdlet ein Objekt erstellt oder ändert, das ein Befehl in der Pipeline verwenden kann. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

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

-PrimaryManagementServer

Gibt ein ManagementServer-Objekt an. Dieser Parameter gibt den primären Verwaltungsserver für den Agent an. Verwenden Sie zum Abrufen eines ManagementServer-Objekts das Cmdlet Get-SCOMManagementServer .

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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