Install-SCOMAgent

Module:

OperationsManager

Implementeert Operations Manager-agents.

Syntaxis

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

Description

De cmdlet Install-SCOMAgent implementeert een of meer Agents voor System Center 2019 - Operations Manager en latere productversies met behulp van clientpushinstallatie. Opmerking: de parameter [-NoAPM] wordt geïntroduceerd met System Center Operations Manager 1807 (deze parameter is niet geldig met System Center 2019 Operations Manager).

Voorbeelden

Voorbeeld 1: Een agent installeren op een server

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

In dit voorbeeld wordt een agent op een server geïnstalleerd en wordt de primaire beheerserver voor de agent ingesteld.

Met de eerste opdracht wordt het beheerserverobject met de naam MgmtServer01.Contoso.com opgehaald en wordt het object opgeslagen in de variabele $PrimaryMgmtServer.

Met de tweede opdracht wordt een agent op Server01.Contoso.com geïnstalleerd en wordt de primaire beheerserver ingesteld op de beheerserver die is opgeslagen in $PrimaryMgmtServer.

Voorbeeld 2: Een agent op een server installeren met behulp van de referenties van het actieaccount

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 dit voorbeeld wordt de gebruiker gevraagd referenties in te voeren en vervolgens de referenties te gebruiken om een agent te installeren.

Met de eerste opdracht wordt de gebruiker om referenties gevraagd en referenties op te slaan in de variabele $InstallAccount.

Met de tweede opdracht wordt het beheerserverobject met de naam MgmtServer01.Contoso.com opgehaald en wordt het object opgeslagen in de $PrimaryMgmtServer variabele.

Met de derde opdracht wordt een agent op Server01.Contoso.com geïnstalleerd met behulp van de referenties die zijn opgeslagen in $InstallAccount en stelt u de primaire beheerserver voor de agent in op de beheerserver die is opgeslagen in $PrimaryMgmtServer.

Voorbeeld 3: Een agent installeren op servers en het actieaccount van de agent instellen

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 dit voorbeeld worden agents op drie computers geïnstalleerd en wordt het agentactieaccount voor de agents ingesteld.

Met de eerste opdracht wordt de naam van drie computers opgeslagen in de variabele $Agents.

Met de tweede opdracht wordt de gebruiker om referenties gevraagd en worden de referenties opgeslagen in de variabele $InstallAccount.

De derde opdracht vraagt de gebruiker om een wachtwoord voor een gebruikersaccount met de naam ActionAccount in het Domein Contoso en slaat de referenties op in de variabele $AgentActionAccount.

Met de vierde opdracht wordt het beheerserverobject met de naam MgmtServer01.Contoso.com opgehaald en wordt het object opgeslagen in de $PrimaryMgmtServer variabele.

Met de vijfde opdracht wordt een agent geïnstalleerd op de drie computers die zijn opgeslagen in de $Agents variabele met behulp van de referenties die zijn opgeslagen in $InstallAccount. Met de opdracht stelt u de primaire beheerserver voor de agent in op de beheerserver die is opgeslagen in $PrimaryMgmtServer en stelt u het actieaccount van de agent in op de ActionAccount-gebruiker die is opgeslagen in $AgentActionAccount.

Parameters

-ActionAccount

Hiermee geeft u een PSCredential-object. Met deze parameter geeft u de referenties op die Operations Manager gebruikt om de implementatietaak uit te voeren. Dit is een verplichte parameter. Als u een null-waarde opgeeft, gebruikt Operations Manager het standaardactieaccount van de beheerserver voor de agent.

Met deze parameter geeft u niet het actieaccount op dat door de agent wordt gebruikt nadat u deze op de computer hebt geïnstalleerd. Het actieaccount dat door de agent wordt gebruikt, is standaard ingesteld op Lokaal systeem. U kunt de parameter AgentActionAccount gebruiken om het actieaccount te wijzigen dat door de agent wordt gebruikt.

Als u een PSCredential--object wilt verkrijgen, gebruikt u de cmdlet Get-Credential. Typ Get-Help Get-Credentialvoor meer informatie.

Type:	PSCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-AgentActionAccount

Hiermee geeft u een PSCredential-object. Met deze parameter geeft u het actieaccount op dat door de agent wordt gebruikt nadat deze op de computer is geïnstalleerd. Het actieaccount dat door de agent wordt gebruikt, is standaard ingesteld op Lokaal systeem. Als u een PSCredential--object wilt verkrijgen, gebruikt u de cmdlet Get-Credential. Typ Get-Help Get-Credentialvoor meer informatie. U kunt de cmdlet Get-SCOMRunAsProfile gebruiken om een Uitvoeren als-account op te halen dat u voor het actieaccount kunt gebruiken.

Type:	PSCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliassen:	cf
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DNSHostName

Hiermee geeft u de naam van een DNS-host (Domain Name System).

Type:	String[]
Aliassen:	Name
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-NoAPM

Dit is een optionele parameter die is geïntroduceerd met System Center Operations Manager 1807 (deze parameter is niet geldig met System Center 2019 Operations Manager), waarmee u de installatie van het APM-onderdeel in de agent kunt kiezen. Gebruik deze parameter om de installatie van het APM-onderdeel in de agent over te slaan.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-PassThru

Geeft aan dat de cmdlet een object maakt of wijzigt dat een opdracht in de pijplijn kan gebruiken. Deze cmdlet genereert standaard geen uitvoer.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-PrimaryManagementServer

Hiermee geeft u een ManagementServer-object. Met deze parameter geeft u de primaire beheerserver voor de agent op. Als u een ManagementServer--object wilt verkrijgen, gebruikt u de cmdlet Get-SCOMManagementServer.

Type:	ManagementServer
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliassen:	wi
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Verwante koppelingen

• Get-SCOMRunAsAccount
• Get-SCOMAgent
• Get-SCOMManagementServer
• Uninstall-SCOMAgent
• Repair-SCOMAgent