Dela via

Install-SCOMAgent

  • Referens
Modul:
OperationsManager

Distribuerar Operations Manager-agenter.

Syntax

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

Description

Cmdleten Install-SCOMAgent distribuerar en eller flera System Center 2019 – Operations Manager och senare produktversionsagenter med hjälp av push-installation av klienter. Obs! Parametern [-NoAPM] introduceras med System Center Operations Manager 1807 (den här parametern är inte giltig med System Center 2019 Operations Manager).

Exempel

Exempel 1: Installera en agent på en server

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

I det här exemplet installeras en agent på en server och den primära hanteringsservern för agenten anges.

Det första kommandot hämtar hanteringsserverobjektet med namnet MgmtServer01.Contoso.com och lagrar objektet i variabeln $PrimaryMgmtServer.

Det andra kommandot installerar en agent på Server01.Contoso.com och anger dess primära hanteringsserver till hanteringsservern som lagras i $PrimaryMgmtServer.

Exempel 2: Installera en agent på en server med hjälp av autentiseringsuppgifterna för åtgärdskontot

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

I det här exemplet uppmanas användaren att ange autentiseringsuppgifter och sedan använda autentiseringsuppgifterna för att installera en agent.

Det första kommandot frågar användaren om autentiseringsuppgifter och lagrar autentiseringsuppgifter i variabeln $InstallAccount.

Det andra kommandot hämtar hanteringsserverobjektet med namnet MgmtServer01.Contoso.com och lagrar objektet i variabeln $PrimaryMgmtServer.

Det tredje kommandot installerar en agent på Server01.Contoso.com med hjälp av autentiseringsuppgifterna som lagras i $InstallAccount och anger den primära hanteringsservern för agenten till hanteringsservern som lagras i $PrimaryMgmtServer.

Exempel 3: Installera en agent på servrar och ange agentåtgärdskontot

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

Det här exemplet installerar agenter på tre datorer och anger agentåtgärdskontot för agenterna.

Det första kommandot lagrar namnet på tre datorer i variabeln $Agents.

Det andra kommandot frågar användaren om autentiseringsuppgifter och lagrar autentiseringsuppgifterna i variabeln $InstallAccount.

Det tredje kommandot uppmanar användaren att ange ett lösenord för ett användarkonto med namnet ActionAccount i Contoso-domänen och lagrar autentiseringsuppgifterna i variabeln $AgentActionAccount.

Det fjärde kommandot hämtar hanteringsserverobjektet med namnet MgmtServer01.Contoso.com och lagrar objektet i variabeln $PrimaryMgmtServer.

Det femte kommandot installerar en agent på de tre datorer som lagras i variabeln $Agents med hjälp av autentiseringsuppgifterna som lagras i $InstallAccount. Kommandot anger den primära hanteringsservern för agenten till hanteringsservern som lagras i $PrimaryMgmtServer och anger agentåtgärdskontot till den ActionAccount-användare som lagras i $AgentActionAccount.

Parametrar

-ActionAccount

Anger ett PSCredential- objekt. Den här parametern anger de autentiseringsuppgifter som Operations Manager använder för att köra distributionsaktiviteten. Det här är en obligatorisk parameter. Om du anger ett null-värde använder Operations Manager standardåtgärdskontot för hanteringsservern för agenten.

Den här parametern anger inte det åtgärdskonto som agenten använder när du har installerat det på datorn. Som standard är åtgärdskontot som agenten använder inställt på Lokalt system. Du kan använda parametern AgentActionAccount för att ändra åtgärdskontot som agenten använder.

Om du vill hämta ett PSCredential--objekt använder du cmdleten Get-Credential. Om du vill ha mer information skriver du Get-Help Get-Credential.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AgentActionAccount

Anger ett PSCredential- objekt. Den här parametern anger det åtgärdskonto som agenten använder när den har installerats på datorn. Som standard är åtgärdskontot som agenten använder inställt på Lokalt system. Om du vill hämta ett PSCredential--objekt använder du cmdleten Get-Credential. Om du vill ha mer information skriver du Get-Help Get-Credential. Du kan använda cmdleten Get-SCOMRunAsProfile för att hämta ett Kör som-konto som du kan använda för åtgärdskontot.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DNSHostName

Anger namnet på en DNS-värd (Domain Name System).

Typ:String[]
Alias:Name
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-NoAPM

Det här är en valfri parameter som introduceras med System Center Operations Manager 1807 (den här parametern är inte giltig med System Center 2019 Operations Manager), som gör att du kan välja installation av APM-komponenten i agenten. Använd den här parametern för att hoppa över installationen av APM-komponenten i agenten.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PassThru

Anger att cmdleten skapar eller ändrar ett objekt som ett kommando kan använda i pipelinen. Som standard genererar den här cmdleten inga utdata.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PrimaryManagementServer

Anger ett ManagementServer- objekt. Den här parametern anger den primära hanteringsservern för agenten. Om du vill hämta ett ManagementServer--objekt använder du cmdleten Get-SCOMManagementServer.

Typ:ManagementServer
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False