Install-SCOMAgent
Wdraża agentów programu Operations Manager.
Składnia
Default (Domyślna)
Install-SCOMAgent
-ActionAccount <PSCredential>
[-AgentActionAccount <PSCredential>]
-DNSHostName <String[]>
-PrimaryManagementServer <ManagementServer>
[-NoAPM]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet Install-SCOMAgent wdraża co najmniej jednego agenta programu System Center 2019 — Operations Manager i nowszej wersji produktu przy użyciu instalacji wypychanej klienta. Uwaga: Parametr [-NoAPM] jest wprowadzany w programie System Center Operations Manager 1807 (ten parametr nie jest prawidł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 ustawiany jest podstawowy serwer zarządzania dla agenta.
Pierwsze polecenie pobiera obiekt serwera zarządzania o nazwie MgmtServer01.Contoso.com i zapisuje go w zmiennej $PrimaryMgmtServer.
Drugie polecenie instaluje agenta w systemie Server01.Contoso.com i ustawia jego 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 monit o wprowadzenie poświadczeń jest wyświetlany, a następnie używa poświadczeń do zainstalowania agenta.
Pierwsze polecenie monituje użytkownika o podanie poświadczeń i przechowywanie poświadczeń w zmiennej $InstallAccount.
Drugie polecenie pobiera obiekt serwera zarządzania o nazwie MgmtServer01.Contoso.com i zapisuje go 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 dla agenta na serwer zarządzania przechowywany w $PrimaryMgmtServer.
Przykład 3: Instalowanie agenta na serwerach i ustawianie konta akcji 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
W tym przykładzie agenci są instalowani na trzech komputerach i ustawiane jest konto akcji agenta dla agentów.
Pierwsze polecenie przechowuje nazwy trzech komputerów w zmiennej $Agents.
Drugie polecenie monituje użytkownika o poświadczenia i zapisuje poświadczenia w zmiennej $InstallAccount.
Trzecie polecenie monituje użytkownika o podanie hasła dla konta użytkownika o nazwie ActionAccount w domenie firmy Contoso i zapisuje poświadczenia w zmiennej $AgentActionAccount.
Czwarte polecenie pobiera obiekt serwera zarządzania o nazwie MgmtServer01.Contoso.com i zapisuje go 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 uruchomienia zadania wdrażania. Jest to obowiązkowy parametr. Jeśli określisz wartość null, program Operations Manager użyje domyślnego konta akcji 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. Za pomocą parametru AgentActionAccount można zmienić konto akcji używane przez agenta.
Aby uzyskać obiekt PSCredential , użyj polecenia cmdlet Get-Credential .
Aby uzyskać więcej informacji, wpisz Get-Help Get-Credential.
Właściwości parametru
| Typ: | PSCredential |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-AgentActionAccount
Określa obiekt PSCredential .
Ten parametr określa konto akcji 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 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 akcji.
Właściwości parametru
| Typ: | PSCredential |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Confirm
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-DNSHostName
Określa nazwę hosta systemu nazw domen (DNS).
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Nazwa |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-NoAPM
Jest to opcjonalny parametr wprowadzony w programie System Center Operations Manager 1807 (ten parametr nie jest prawidłowy w programie System Center 2019 Operations Manager), który umożliwia wybór instalacji składnika APM w agencie. Użyj tego parametru, aby pominąć instalację komponentu APM w agencie.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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 żadnych danych wyjściowych.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-PrimaryManagementServer
Określa obiekt ManagementServer . Ten parametr określa podstawowy serwer zarządzania dla agenta. Aby uzyskać obiekt ManagementServer , użyj polecenia cmdlet Get-SCOMManagementServer .
Właściwości parametru
| Typ: | ManagementServer |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.