Распространение агентов через Microsoft System Center Configuration Manager
Распространение агентов на конечные устройства с помощью Microsoft System Center Configuration Manager (SCCM) осуществляется только в ОС Windows и состоит из следующих этапов:
Подготовка сервера SCCM
Для распространения агентов через Microsoft System Center Configuration Manager необходимо иметь настроенный сервер SCCM с подключенными к нему устройствами Windows.
| Настройку сервера необходимо выполнять с помощью ИТ-службы вашей организации. |
Подготовка установочных файлов
Перед созданием приложения в SCCM подготовьте сетевой каталог с установочными файлами. Для этого:
-
Создайте сетевой каталог, доступный с сервера управления SCCM.
-
Разместите в созданном каталоге следующие файлы:
-
Установщик агента — MSI-файл.
-
Корневой TLS-сертификат, например,
ca_root.cer. Инструкция по созданию сертификата приведена в разделе Добавление TLS-сертификата на хосте агента. Подготовленный файл должен полностью совпадать с сертификатом, установленным на сервере шлюза. -
Скрипт установки агента
sccm_agent_install.ps1со следующим содержимым:Текст скрипта
sccm_agent_install.ps1param( [string]$GatewayUrl = "tls://test.local:30005", [string]$MsiFileName = "agent.msi", [string]$CaCertFileName = "ca_root.cer" ) # Install CA Certificate. Write-Host "Installing CA certificate..." $certPath = Join-Path $PSScriptRoot $CaCertFileName if (Test-Path $certPath) { try { # Import certificate to Trusted Root Certification Authorities. Import-Certificate -FilePath $certPath -CertStoreLocation Cert:\LocalMachine\Root Write-Host "CA certificate installed successfully" } catch { Write-Error "Failed to install CA certificate: $_" exit 1 } } else { Write-Warning "CA certificate not found at $certPath - skipping certificate installation" } # Install the MSI. Write-Host "Installing $MsiFileName..." $msiPath = "$PSScriptRoot\$MsiFileName" if (-not (Test-Path $msiPath)) { Write-Error "MSI file not found at $msiPath" exit 1 } Start-Process -FilePath "msiexec.exe" -ArgumentList "/i `"$msiPath`" /qn" -Wait -NoNewWindow # Wait a moment to ensure installation completes. Start-Sleep -Seconds 60 # Run the agent launcher with the gateway URL. Write-Host "Starting agent with gateway URL: $GatewayUrl" $agentPath = "C:\Program Files (x86)\RVision\Agent\bin\rpoint-launcher.exe" if (Test-Path $agentPath) { Start-Process -FilePath $agentPath -ArgumentList "start --gateway-url=$GatewayUrl" -NoNewWindow Write-Host "Agent started successfully" } else { Write-Error "Agent launcher not found at $agentPath" exit 1 } exit 0Редактировать значения параметров внутри скрипта не требуется. Указанные в коде значения, например, tls://test.local:30005, приведены в качестве примера формата. Актуальные данные для вашей инфраструктуры будут переданы скрипту автоматически через параметры командной строки на этапе настройки приложения в SCCM.
-
Создание приложения для установки агента
Чтобы создать приложение для распространения в SCCM:
-
Откройте консоль управления SCCM.
-
Перейдите в раздел Software Library → Overview → Application Management → Applications.
-
Нажмите на кнопку Create Application в главном меню. Откроется мастер создания приложения.
-
На вкладке General выберите опцию Manually specify the application information.
-
На вкладках General Information и Application Catalog задайте имя приложения и при необходимости укажите метаданные.
-
Перейдите на вкладку Deployment Types и нажмите на кнопку Add. Откроется мастер создания типа развертывания.
-
На вкладке General в поле Type выберите тип Script Installer.
-
На вкладке General Information задайте имя скрипта.
-
На вкладке Content укажите параметры для установки:
-
Content location: введите адрес сетевого каталога с установочными файлами, созданного на шаге Подготовка установочных файлов, например,
\\sccm1902\sccm_agent_install. -
Installation program: введите команду запуска скрипта установки:
powershell.exe -ExecutionPolicy Bypass -NoProfile -File "sccm_agent_install.ps1" -GatewayUrl "<gateway_url>" -CaCertFileName "<cert_file_name>" -MsiFileName "<msi_file_name>"Здесь:
-
<gateway_url>— адрес и порт шлюза для подключения агента. При использовании TLS-соединения адрес должен начинаться сtls://, иначе — сnats://. Например:tls://gateway.local:32123илиnats://gateway.local:32123. -
<cert_file_name>— название файла корневого сертификата для агента, например,ca_root.cer. -
<msi_file_name>— имя MSI-файла агента, например,evo-agent-1.0.1632.17872.s-x64.msi.
-
-
-
Перейдите на вкладку Detection Method и нажмите на кнопку Add Clause. Откроется окно создания правила обнаружения.
-
Настройте правило:
-
Setting Type: выберите вариант Windows Installer.
-
Product code: нажмите на кнопку Browse и выберите MSI-файл агента. Код продукта заполнится автоматически.
-
-
Перейдите на вкладку User Experience и задайте следующие параметры:
-
Installation behavior: выберите вариант Install for system.
-
Logon requirement: выберите вариант Whether or not a user is logged on.
-
Installation program visibility: выберите вариант Normal.
-
-
На остальных вкладках в мастере создания типа развертывания оставьте значения по умолчанию.
-
Вернитесь в мастер создания приложения и на вкладке Deployment Types выберите пакет, созданный на предыдущих шагах.
-
Завершите создание приложения.
Развертывание приложения на устройства
После создания приложения необходимо назначить его на нужную группу устройств. Для этого:
-
В консоли управления SCCM перейдите в раздел Software Library → Overview → Application Management → Applications. В списке появится созданное приложение для установки агента.
-
Выберите приложение и нажмите на кнопку Deploy в главном меню. Откроется мастер развертывания программного обеспечения.
-
Выберите коллекцию устройств, к которой требуется применить установку приложения.
-
Перейдите на вкладку Deployment Settings и задайте следующие параметры установки:
-
Action: выберите вариант Install.
-
Purpose: выберите вариант Required.
-
-
Пройдите все шаги мастера установки до конца. При необходимости на вкладке Scheduling задайте дату и время установки.
-
Дождитесь завершения установки от SCCM.
Проверка статуса установки
В результате выполненных действий должна начаться автоматическая установка агента на устройствах с сервера SCCM.
Для централизованной проверки статуса развертывания и выявления возможных ошибок выполните следующие действия:
-
Откройте консоль управления SCCM.
-
Перейдите в раздел Software Library → Overview → Application Management → Applications.
-
Выберите созданное приложение для установки агента.
-
Перейдите на вкладку Deployments.
-
Нажмите на кнопку View Status. Система отобразит текущий статус установки приложения и краткое сообщение об ошибке в случае сбоя.
Если установка не началась автоматически, выполните следующие действия на целевом хосте:
-
Зайдите на хост, на который должен распространиться пакет.
-
Откройте центр программного обеспечения Windows.
-
Перейдите в раздел Параметры → Обслуживание компьютера → Синхронизация политики. Приблизительно через минуту в поле Состояние установки должен появиться распространяемый файл, около которого будет указан статус: установлено или сбой.
Для получения подробной информации о причинах сбоя установки изучите логи SCCM. Файлы логов располагаются на каждом целевом хосте в директории C:\Windows\CCM\Logs\.
|
Была ли полезна эта страница?