Распространение агентов через Microsoft System Center Configuration Manager

Распространение агентов на конечные устройства с помощью Microsoft System Center Configuration Manager (SCCM) осуществляется только в ОС Windows и состоит из следующих этапов:

Подготовка сервера SCCM

Для распространения агентов через Microsoft System Center Configuration Manager необходимо иметь настроенный сервер SCCM с подключенными к нему устройствами Windows.

Настройку сервера необходимо выполнять с помощью ИТ-службы вашей организации.

Подготовка установочных файлов

Перед созданием приложения в SCCM подготовьте сетевой каталог с установочными файлами. Для этого:

  1. Создайте сетевой каталог, доступный с сервера управления SCCM.

  2. Разместите в созданном каталоге следующие файлы:

    • Установщик агента — MSI-файл.

    • Корневой TLS-сертификат, например, ca_root.cer. Инструкция по созданию сертификата приведена в разделе Добавление TLS-сертификата на хосте агента. Подготовленный файл должен полностью совпадать с сертификатом, установленным на сервере шлюза.

    • Скрипт установки агента sccm_agent_install.ps1 со следующим содержимым:

      Текст скрипта sccm_agent_install.ps1
      param(
      [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:

  1. Откройте консоль управления SCCM.

  2. Перейдите в раздел Software Library → Overview → Application Management → Applications.

  3. Нажмите на кнопку Create Application в главном меню. Откроется мастер создания приложения.

  4. На вкладке General выберите опцию Manually specify the application information.

  5. На вкладках General Information и Application Catalog задайте имя приложения и при необходимости укажите метаданные.

  6. Перейдите на вкладку Deployment Types и нажмите на кнопку Add. Откроется мастер создания типа развертывания.

  7. На вкладке General в поле Type выберите тип Script Installer.

  8. На вкладке General Information задайте имя скрипта.

  9. На вкладке 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.

  10. Перейдите на вкладку Detection Method и нажмите на кнопку Add Clause. Откроется окно создания правила обнаружения.

  11. Настройте правило:

    • Setting Type: выберите вариант Windows Installer.

    • Product code: нажмите на кнопку Browse и выберите MSI-файл агента. Код продукта заполнится автоматически.

  12. Перейдите на вкладку User Experience и задайте следующие параметры:

    • Installation behavior: выберите вариант Install for system.

    • Logon requirement: выберите вариант Whether or not a user is logged on.

    • Installation program visibility: выберите вариант Normal.

  13. На остальных вкладках в мастере создания типа развертывания оставьте значения по умолчанию.

  14. Вернитесь в мастер создания приложения и на вкладке Deployment Types выберите пакет, созданный на предыдущих шагах.

  15. Завершите создание приложения.

Развертывание приложения на устройства

После создания приложения необходимо назначить его на нужную группу устройств. Для этого:

  1. В консоли управления SCCM перейдите в раздел Software Library → Overview → Application Management → Applications. В списке появится созданное приложение для установки агента.

  2. Выберите приложение и нажмите на кнопку Deploy в главном меню. Откроется мастер развертывания программного обеспечения.

  3. Выберите коллекцию устройств, к которой требуется применить установку приложения.

  4. Перейдите на вкладку Deployment Settings и задайте следующие параметры установки:

    • Action: выберите вариант Install.

    • Purpose: выберите вариант Required.

  5. Пройдите все шаги мастера установки до конца. При необходимости на вкладке Scheduling задайте дату и время установки.

  6. Дождитесь завершения установки от SCCM.

Проверка статуса установки

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

Для централизованной проверки статуса развертывания и выявления возможных ошибок выполните следующие действия:

  1. Откройте консоль управления SCCM.

  2. Перейдите в раздел Software Library → Overview → Application Management → Applications.

  3. Выберите созданное приложение для установки агента.

  4. Перейдите на вкладку Deployments.

  5. Нажмите на кнопку View Status. Система отобразит текущий статус установки приложения и краткое сообщение об ошибке в случае сбоя.

Если установка не началась автоматически, выполните следующие действия на целевом хосте:

  1. Зайдите на хост, на который должен распространиться пакет.

  2. Откройте центр программного обеспечения Windows.

  3. Перейдите в раздел Параметры → Обслуживание компьютера → Синхронизация политики. Приблизительно через минуту в поле Состояние установки должен появиться распространяемый файл, около которого будет указан статус: установлено или сбой.

Для получения подробной информации о причинах сбоя установки изучите логи SCCM. Файлы логов располагаются на каждом целевом хосте в директории C:\Windows\CCM\Logs\.

Была ли полезна эта страница?

Обратная связь