Auf Englisch lesen

Freigeben über

Install-SCOMAgent

  • Referenz
Modul:
OperationsManager

Stellt Operations Manager-Agents bereit.

Syntax

PowerShell 
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 nicht gültig).

Beispiele

Beispiel 1: Installieren eines Agents auf einem Server

PowerShell 
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 Variablen.

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

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

PowerShell 
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 zu erhalten und Anmeldeinformationen in der variablen $InstallAccount zu speichern.

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

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 Agents auf Servern und Festlegen des Agent-Aktionskontos

PowerShell 
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 auf, ein Kennwort für ein Benutzerkonto namens "ActionAccount" in der Contoso-Domäne einzugeben und die Anmeldeinformationen in der variablen $AgentActionAccount zu speichern.

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 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 in $PrimaryMgmtServer gespeicherten Verwaltungsserver fest 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. Wenn Sie diesen Parameter nicht angeben oder 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 Parameter AgentActionAccount 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 eine Run As-Konten abzurufen, die 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 mit System Center 2019 Operations Manager nicht 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