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 ein oder mehrere System Center 2019 - Operations Manager und höhere Produktversions-Agents mithilfe der Client-Pushinstallation bereit. Hinweis: [-NoAPM]-Parameter wird mit System Center Operations Manager 1807 eingeführt (dieser Parameter ist mit System Center 2019 Operations Manager ungültig).

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 mit dem Namen MgmtServer01.Contoso.com ab und speichert das Objekt in der variablen $PrimaryMgmtServer.

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 für das Aktionskonto

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 zur Eingabe von Anmeldeinformationen auf und speichert Anmeldeinformationen in der variablen $InstallAccount.

Der zweite Befehl ruft das Verwaltungsserverobjekt mit dem Namen MgmtServer01.Contoso.com ab und speichert das Objekt in der $PrimaryMgmtServer Variablen.

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

Beispiel 3: Installieren eines Agents 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 Agent-Aktionskonto für die Agents festgelegt.

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

Der zweite Befehl fordert den Benutzer zur Eingabe von Anmeldeinformationen auf und speichert die Anmeldeinformationen in der variablen $InstallAccount.

Der dritte Befehl fordert den Benutzer zur Eingabe eines Kennworts für ein Benutzerkonto namens "ActionAccount" in der Contoso-Domäne auf und speichert die Anmeldeinformationen in der variablen $AgentActionAccount.

Der vierte Befehl ruft das Verwaltungsserverobjekt mit dem Namen MgmtServer01.Contoso.com ab und speichert das Objekt in der variablen $PrimaryMgmtServer.

Mit dem fünften Befehl wird ein Agent auf den drei Computern installiert, die in der variablen $Agents gespeichert sind, indem die in $InstallAccount gespeicherten Anmeldeinformationen verwendet werden. Der Befehl legt den primären Verwaltungsserver für den Agent auf den verwaltungsserver fest, der in $PrimaryMgmtServer gespeichert ist, und legt das Agent-Aktionskonto 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 obligatorischer Parameter. Wenn Sie einen NULL-Wert 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 vom Agent verwendete Aktionskonto auf "Lokales System" festgelegt. Sie können den parameter AgentActionAccount verwenden, um das vom Agent verwendete Aktionskonto zu ändern.

Um ein PSCredential-Objekt abzurufen, verwenden Sie das Cmdlet Get-Credential. Geben Sie Get-Help Get-Credentialein, um weitere Informationen zu erfahren.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 vom Agent verwendete Aktionskonto auf "Lokales System" festgelegt. Um ein PSCredential-Objekt abzurufen, verwenden Sie das Cmdlet Get-Credential. Geben Sie Get-Help Get-Credentialein, um weitere Informationen zu erfahren. Sie können das cmdlet Get-SCOMRunAsProfile verwenden, um ein Run As-Konto abzurufen, das Sie für das Aktionskonto verwenden können.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DNSHostName

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

Typ:String[]
Aliase:Name
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-NoAPM

Dies ist ein optionaler Parameter, der mit System Center Operations Manager 1807 eingeführt wurde (dieser Parameter ist mit System Center 2019 Operations Manager ungü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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PrimaryManagementServer

Gibt ein ManagementServer- -Objekt an. Dieser Parameter gibt den primären Verwaltungsserver für den Agent an. Um ein ManagementServer--Objekt abzurufen, verwenden Sie das cmdlet Get-SCOMManagementServer.

Typ:ManagementServer
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False