Install-SCOMAgent
Развертывает агенты Operations Manager.
Синтаксис
Default (по умолчанию)
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 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-AgentActionAccount
Указывает объект PSCredential.
Этот параметр указывает учетную запись действия, которую агент использует после установки на компьютере.
По умолчанию учетная запись действия, которую использует агент, имеет значение Local System.
Чтобы получить объект PSCredential, используйте командлет Get-Credential.
Дополнительные сведения см. в Get-Help Get-Credential.
Для получения учетных записей запуска от имени можно использовать командлет Get-SCOMRunAsProfile, чтобы получить учетные записи запуска от имени, которые можно использовать для учетной записи действия.
Свойства параметра
| Тип: | PSCredential |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Запрашивает подтверждение перед запуском командлета.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DNSHostName
Указывает имя узла системы доменных имен (DNS).
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Имя |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-NoAPM
Это необязательный параметр, представленный в System Center Operations Manager 1807 (этот параметр недопустим в System Center 2019 Operations Manager), который позволяет выбрать установку компонента APM в агенте. Используйте этот параметр, чтобы пропустить установку компонента APM в агенте.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PassThru
Указывает, что командлет создает или изменяет объект, который команда может использовать в конвейере. По умолчанию этот командлет не создает выходные данные.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PrimaryManagementServer
Указывает объект ManagementServer. Этот параметр задает основной сервер управления для агента. Чтобы получить объект ManagementServer, используйте командлет Get-SCOMManagementServer.
Свойства параметра
| Тип: | ManagementServer |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.