Расширения консоли Import Configuration Manager

Относится к: Configuration Manager (Current Branch)

Начиная с Configuration Manager 2103, можно импортировать расширения консоли, которые будут использоваться в вашей среде. Эти расширения показываются в узле расширений консоли. Импорт и просто наличие расширений на консоли не делают их сразу доступными. Администратору по-прежнему необходимо утвердить расширение сайта и включить уведомления. Затем пользователи консоли могут установить расширение на локализованную консоль. Дополнительные сведения об управлении и установке расширений консоли см. в дополнительных сведениях об управлении расширениями консоли Configuration Manager.

В зависимости от версии диспетчера конфигурации доступны различные параметры импорта. Изначально только подписанные расширения можно было импортировать через службу администрирования. Поддержка импорта неподписаных расширений была добавлена позже. Затем в версии 2111 был представлен мастер, который мог импортировать для вас как подписанные, так и неподписаные расширения без запуска сценария.

Версия Configuration Manager 2103 2107 2111 или более поздний
Импорт подписанного расширения Да Да Да
Импорт неподписаного расширения Нет Да, когда вы разрешаете неподписав Да, когда вы разрешаете неподписав
Импорт из службы администрирования с помощью сценария PowerShell Да, только подписанные расширения Да Да
Импорт из мастера расширения консолей импорта Нет Нет Да

Импорт расширений консоли

Чтобы импортировать расширения консоли, выполните четыре основных действия. Точно, как можно импортировать, будет определяться используемой вами версией Диспетчер конфигурации, и подписано ли расширение или нет. Чтобы импортировать и устанавливать утвержденное расширение консоли иерархии, необходимо сделать следующие действия:

  1. Определите, нужно ли разрешить неподписаные расширения консоли с утвержденными иерархиями (версия 2107 и более поздней версии).
  2. Импорт расширения консоли с помощью одного из следующих методов:
  3. Проверьте расширение на локальной консоли.
  4. Включить уведомления, позволяющие пользователям консоли устанавливать расширение консоли.

Разрешить неподписаные расширения консоли для иерархии

(Применяется к версии Configuration Manager 2107 или более поздней версии)

Начиная с версии Configuration Manager 2107, вы можете разрешить неподписаные расширения консоли, утвержденные иерархией. Для сведения к минимуму рисков безопасности и подтверждения подлинности расширения консоли всегда используются подписанные расширения. Однако в некоторых случаях может потребоваться разрешить неподписаные расширения консоли из-за неподписаного расширения внутренней разработки или для тестирования собственного пользовательского расширения в лаборатории. Чтобы разрешить импорт и установку неподписаных расширений консоли, утвержденных иерархией, необходимо включить параметр иерархии.

  1. В консоли Configuration Manager перейдите в рабочее пространство Администрирование, расширьте конфигурацию сайта и выберите Сайты.
  2. Выберите иерархию Параметры из ленты.
  3. На вкладке General включить утвержденные расширения консоли Иерархия можно без подписи.
  4. Выберите Ok при закрытии иерархии Параметры свойств.

Примечание

В настоящее время, когда неподписанным расширением не включено уведомление пользователя,в узле Расширения консоли столбец Required остается пустым, а не заполняет значение No.

Импорт подписанного расширения консоли со сценарием

(Применяется к версии Configuration Manager 2103 или более поздней версии)

Если расширение упаковано в подписанный файл, его .cab можно импортировать в Configuration Manager. Это можно сделать, разместив его в службе администрирования с помощью сценария PowerShell. После вставки расширения на сайт можно утвердить и установить его локально из узла расширения консоли. Чтобы импортировать, запустите следующий скрипт PowerShell после редактирования $adminServiceProvider $cabFilePath и:

  • $adminServiceProvider — сервер SMSProvider верхнего уровня, на котором установлена служба администрирования
  • $cabFilePath - Путь к подписанного .cab файла расширения
$adminServiceProvider = "SMSProviderServer.contoso.com"
$cabFilePath = "C:\Testing\MyExtension.cab"
$adminServiceURL = "https://$adminServiceProvider/AdminService/v1/ConsoleExtensionMetadata/AdminService.UploadExtension"
$cabFileName = (Get-Item -Path $cabFilePath).Name
$Data = Get-Content $cabFilePath
$Bytes = [System.IO.File]::ReadAllBytes($cabFilePath)
$base64Content = [Convert]::ToBase64String($Bytes)
   
   $Headers = @{
       "Content-Type" = "Application/json"
   }
   
   $Body = @{
               CabFile = @{
                   FileName = $cabFileName
                   FileContent = $base64Content
               }
           } | ConvertTo-Json
   
   $result = Invoke-WebRequest -Method Post -Uri $adminServiceURL -Body $Body -Headers $Headers -UseDefaultCredentials
   
if ($result.StatusCode -eq 200) {Write-Host "$cabFileName was published successfully."}
else {Write-Host "$cabFileName publish failed. Review AdminService.log for more information."}

Импорт неподписаного расширения консоли со сценарием

(Применяется к версии Configuration Manager 2107 или более поздней версии)

Начиная с версии Configuration Manager 2107, вы можете разрешить неподписаные расширения консоли, утвержденные иерархией. Для сведения к минимуму рисков безопасности и подтверждения подлинности расширения консоли всегда используются подписанные расширения. Однако в некоторых случаях может потребоваться разрешить неподписаные расширения консоли из-за неподписаного расширения внутренней разработки или для тестирования собственного пользовательского расширения в лаборатории.

Если у вас есть .cab файл для расширения, вы можете протестировать его в лаборатории Configuration Manager. Вы сделаете это, разместив его через службу администрирования. После вставки расширения на сайте вы можете утвердить его и установить локально из узла расширения консоли. Чтобы импортировать, запустите следующий скрипт PowerShell после редактирования $adminServiceProvider $cabFilePath и:

  • $adminServiceProvider — сервер SMSProvider верхнего уровня, на котором установлена служба администрирования
  • $cabFilePath - Путь к файлу .cab расширения
$adminServiceProvider = "SMSProviderServer.contoso.com"
$cabFilePath = "C:\Testing\MyExtension.cab"
$adminServiceURL = "https://$adminServiceProvider/AdminService/v1/ConsoleExtensionMetadata/AdminService.UploadExtension"
$cabFileName = (Get-Item -Path $cabFilePath).Name
$Data = Get-Content $cabFilePath
$Bytes = [System.IO.File]::ReadAllBytes($cabFilePath)
$base64Content = [Convert]::ToBase64String($Bytes)
$Headers = @{
    "Content-Type" = "Application/json"
}
$Body = @{
            CabFile = @{
                FileName = $cabFileName
                FileContent = $base64Content
            }
            AllowUnsigned = $true
        } | ConvertTo-Json
$result = Invoke-WebRequest -Method Post -Uri $adminServiceURL -Body $Body -Headers $Headers -UseDefaultCredentials
if ($result.StatusCode -eq 200) {Write-Host "$cabFileName was published successfully."}
else {Write-Host "$cabFileName publish failed. Review AdminService.log for more information."}

Примечание

В настоящее время, когда неподписанным расширением не включено уведомление пользователя,в узле Расширения консоли столбец Required остается пустым, а не заполняет значение No.

Мастер импортных расширений консоли

(Применяется к версии Configuration Manager 2111 или более поздней версии)

Начиная с версии 2111 можно использовать мастер расширения импортных консолей для импорта расширений консоли, управляемых для иерархии. Вам больше не нужно использовать сценарий PowerShell для импорта подписанного или неподписаного расширения консоли. Импорт расширения консоли с помощью мастера:

  1. В рабочей области Администрирование разберем обновления и обслуживание, а затем выберите узел расширения консоли.
  2. Выберите расширение импортной консоли из ленты или меню правой кнопкой мыши.
  3. При запуске мастера выберите Обзор и перейдите к файлу кабины расширения.
  4. При необходимости выберите параметр Разрешить расширение без подписи.
  5. Выберите Далее, чтобы просмотреть сводку импорта, а затем завершить мастер импортировать расширение.

Примечание

Чтобы импортировать неподписаные расширения, утвержденные иерархией консольные расширения могут быть включены в иерархии Параметры. Дополнительные сведения см. в документе Разрешить неподписаныерасширения консоли, утвержденные иерархией.

Установка и тестирование расширения на локальной консоли

  1. Измените область безопасности для расширения. Изменение области безопасности рекомендуется для начального тестирования расширения.

    1. Перейдите к узлу расширений консоли в статье Обновления и обслуживание обзоров > > администрирования.
    2. Выберите расширение, а затем установите области безопасности из ленты.
    3. Удалите область безопасности по умолчанию и добавьте область, которая содержит только одного или двух администраторов для первоначального тестирования.
    4. Выберите ОК, чтобы сохранить область безопасности для расширения.
  2. Утвердить расширение, выбрав утверждение установки из ленты или правой кнопкой мыши меню.

    • Если расширение не утверждено, вы не сможете установить его или включить в консоли уведомления для него.
    • Если вы перезапустите консоль в этот момент, уведомление о доступном расширении не будет происходить, так как вы еще не включили параметр.
  3. Установите расширение на локальной консоли, выбрав установите.

  4. После установки расширения убедитесь, что оно отображается, и вы можете использовать его с локальной консоли.

Включить уведомления пользователей для установки расширения

  1. При необходимости измените области безопасности для расширения, чтобы разрешить доступ к нему для большего объема администраторов. Эти администраторы будут направлены с уведомлением в консоли для установки расширения.
  2. Выберите Включить уведомления.
  3. Запустите консоль Configuration Manager, на которую не установлено расширение. В идеале используйте тестовую учетную запись, к которую вы получили доступ при внесении изменений в область безопасности.
  4. Убедитесь, что уведомление о расширении происходит и что можно установить расширение.

Дальнейшие действия