Udostępnij za pośrednictwem

Install-SCOMAgent

  • Odwołanie
Moduł:
OperationsManager

Wdraża agentów programu Operations Manager.

Składnia

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

Opis

Polecenie cmdlet Install-SCOMAgent wdraża co najmniej jeden agent programu System Center 2019 — Operations Manager i nowszych wersji produktu przy użyciu instalacji wypychanej klienta. Uwaga: parametr [-NoAPM] jest wprowadzany w programie System Center Operations Manager 1807 (ten parametr jest nieprawidłowy w programie System Center 2019 Operations Manager).

Przykłady

Przykład 1. Instalowanie agenta na serwerze

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

W tym przykładzie agent jest instalowany na serwerze i ustawia podstawowy serwer zarządzania agenta.

Pierwsze polecenie pobiera obiekt serwera zarządzania o nazwie MgmtServer01.Contoso.com i przechowuje obiekt w zmiennej $PrimaryMgmtServer.

Drugie polecenie instaluje agenta na Server01.Contoso.com i ustawia podstawowy serwer zarządzania na serwer zarządzania przechowywany w $PrimaryMgmtServer.

Przykład 2. Instalowanie agenta na serwerze przy użyciu poświadczeń konta działania

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

W tym przykładzie zostanie wyświetlony monit o wprowadzenie poświadczeń przez użytkownika, a następnie użycie poświadczeń do zainstalowania agenta.

Pierwsze polecenie wyświetla użytkownikowi monit o poświadczenia i przechowuje poświadczenia w zmiennej $InstallAccount.

Drugie polecenie pobiera obiekt serwera zarządzania o nazwie MgmtServer01.Contoso.com i przechowuje obiekt w zmiennej $PrimaryMgmtServer.

Trzecie polecenie instaluje agenta na Server01.Contoso.com przy użyciu poświadczeń przechowywanych w $InstallAccount i ustawia podstawowy serwer zarządzania agenta na serwer zarządzania przechowywany w $PrimaryMgmtServer.

Przykład 3. Instalowanie agenta na serwerach i ustawianie konta działania agenta

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

Ten przykład instaluje agentów na trzech komputerach i ustawia konto działania agenta dla agentów.

Pierwsze polecenie przechowuje nazwę trzech komputerów w zmiennej $Agents.

Drugie polecenie wyświetla użytkownikowi monit o poświadczenia i przechowuje poświadczenia w zmiennej $InstallAccount.

Trzecie polecenie wyświetla użytkownikowi hasło dla konta użytkownika o nazwie ActionAccount w domenie Contoso i przechowuje poświadczenia w zmiennej $AgentActionAccount.

Czwarte polecenie pobiera obiekt serwera zarządzania o nazwie MgmtServer01.Contoso.com i przechowuje obiekt w zmiennej $PrimaryMgmtServer.

Piąte polecenie instaluje agenta na trzech komputerach przechowywanych w zmiennej $Agents przy użyciu poświadczeń przechowywanych w $InstallAccount. Polecenie ustawia podstawowy serwer zarządzania agenta na serwer zarządzania przechowywany w $PrimaryMgmtServer i ustawia konto działania agenta na użytkownika ActionAccount przechowywanego w $AgentActionAccount.

Parametry

-ActionAccount

Określa obiekt PSCredential . Ten parametr określa poświadczenia używane przez program Operations Manager do uruchamiania zadania wdrożenia. Ten parametr jest wymagany . Jeśli określisz wartość null, program Operations Manager używa domyślnego konta działania serwera zarządzania dla agenta.

Ten parametr nie określa konta działania używanego przez agenta po zainstalowaniu go na komputerze. Domyślnie konto działania używane przez agenta jest ustawione na system lokalny. Możesz użyć parametru AgentActionAccount , aby zmienić konto działania używane przez agenta.

Aby uzyskać obiekt PSCredential , użyj polecenia cmdlet Get-Credential . Aby uzyskać więcej informacji, wpisz polecenie Get-Help Get-Credential.

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

-AgentActionAccount

Określa obiekt PSCredential . Ten parametr określa konto działania używane przez agenta po zainstalowaniu go na komputerze. Domyślnie konto działania używane przez agenta jest ustawione na system lokalny. Aby uzyskać obiekt PSCredential , użyj polecenia cmdlet Get-Credential . Aby uzyskać więcej informacji, wpisz polecenie Get-Help Get-Credential. Możesz użyć polecenia cmdlet Get-SCOMRunAsProfile , aby uzyskać konta Uruchom jako, których można użyć dla konta działania.

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-DNSHostName

Określa nazwę hosta systemu nazw domen (DNS).

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

-NoAPM

Jest to opcjonalny parametr wprowadzony w programie System Center Operations Manager 1807 (ten parametr jest nieprawidłowy w programie System Center 2019 Operations Manager), który umożliwia wybranie instalacji składnika APM w agencie. Użyj tego parametru, aby pominąć instalację składnika APM w agencie.

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

-PassThru

Wskazuje, że polecenie cmdlet tworzy lub modyfikuje obiekt, którego polecenie może użyć w potoku. Domyślnie to polecenie cmdlet nie generuje żadnego wyniku.

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

-PrimaryManagementServer

Określa obiekt ManagementServer . Ten parametr określa podstawowy serwer zarządzania agenta. Aby uzyskać obiekt ManagementServer , użyj polecenia cmdlet Get-SCOMManagementServer .

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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