Поделиться через

Install-SCOMAgent

  • Ссылка
Модуль:
OperationsManager

Развертывает агенты Operations Manager.

Синтаксис

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

Описание

Командлет Install-SCOMAgent развертывает один или несколько агентов версии продукта System Center 2019 — Operations Manager и более поздних версий с помощью принудительной установки клиента. Примечание. Параметр [-NoAPM] представлен в System Center Operations Manager 1807 (этот параметр недопустим в System Center 2019 Operations Manager).

Примеры

Пример 1. Установка агента на сервере

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

В этом примере агент устанавливается на сервере и задает основной сервер управления для агента.

Первая команда получает объект сервера управления с именем MgmtServer01.Contoso.com и сохраняет объект в переменной $PrimaryMgmtServer.

Вторая команда устанавливает агент на Server01.Contoso.com и задает его основной сервер управления на сервер управления, хранящийся в $PrimaryMgmtServer.

Пример 2. Установка агента на сервере с помощью учетных данных учетной записи действия

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

В этом примере пользователю предлагается ввести учетные данные, а затем использовать учетные данные для установки агента.

Первая команда задает пользователю учетные данные и сохраняет учетные данные в переменной $InstallAccount.

Вторая команда получает объект сервера управления с именем MgmtServer01.Contoso.com и сохраняет объект в переменной $PrimaryMgmtServer.

Третья команда устанавливает агент на Server01.Contoso.com с помощью учетных данных, хранящихся в $InstallAccount, и задает основной сервер управления для агента на сервер управления, хранящийся в $PrimaryMgmtServer.

Пример 3. Установка агента на серверах и настройка учетной записи действия агента

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

В этом примере агенты устанавливаются на трех компьютерах и задаются учетные записи действия агента для агентов.

Первая команда сохраняет имя трех компьютеров в переменной $Agents.

Вторая команда запрашивает у пользователя учетные данные и сохраняет учетные данные в переменной $InstallAccount.

Третья команда запрашивает пароль для учетной записи пользователя с именем ActionAccount в домене Contoso и сохраняет учетные данные в переменной $AgentActionAccount.

Четвертая команда получает объект сервера управления с именем MgmtServer01.Contoso.com и сохраняет объект в переменной $PrimaryMgmtServer.

Пятая команда устанавливает агент на трех компьютерах, хранящихся в переменной $Agents, с помощью учетных данных, хранящихся в $InstallAccount. Команда задает основной сервер управления для агента на сервер управления, хранящийся в $PrimaryMgmtServer, и задает учетную запись действия агента пользователю ActionAccount, хранящейся в $AgentActionAccount.

Параметры

-ActionAccount

Указывает объект PSCredential. Этот параметр указывает учетные данные, которые Operations Manager использует для выполнения задачи развертывания. Это обязательный параметр. Если указать значение NULL, Operations Manager использует учетную запись действия по умолчанию сервера управления для агента.

Этот параметр не указывает учетную запись действия, которую агент использует после установки на компьютере. По умолчанию учетная запись действия, которую использует агент, имеет значение Local System. Вы можете использовать параметр AgentActionAccount для изменения учетной записи действия, используемой агентом.

Чтобы получить объект PSCredential, используйте командлет Get-Credential. Дополнительные сведения см. в Get-Help Get-Credential.

Тип:PSCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AgentActionAccount

Указывает объект PSCredential. Этот параметр указывает учетную запись действия, которую агент использует после установки на компьютере. По умолчанию учетная запись действия, которую использует агент, имеет значение Local System. Чтобы получить объект PSCredential, используйте командлет Get-Credential. Дополнительные сведения см. в Get-Help Get-Credential. Для получения учетных записей запуска от имени можно использовать командлет Get-SCOMRunAsProfile, чтобы получить учетные записи запуска от имени, которые можно использовать для учетной записи действия.

Тип:PSCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DNSHostName

Указывает имя узла системы доменных имен (DNS).

Тип:String[]
Aliases:Name
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-NoAPM

Это необязательный параметр, представленный в System Center Operations Manager 1807 (этот параметр недопустим в System Center 2019 Operations Manager), который позволяет выбрать установку компонента APM в агенте. Используйте этот параметр, чтобы пропустить установку компонента APM в агенте.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PassThru

Указывает, что командлет создает или изменяет объект, который команда может использовать в конвейере. По умолчанию этот командлет не создает выходные данные.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PrimaryManagementServer

Указывает объект ManagementServer. Этот параметр задает основной сервер управления для агента. Чтобы получить объект ManagementServer, используйте командлет Get-SCOMManagementServer.

Тип:ManagementServer
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False