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

Статья
04/04/2023

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

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

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

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

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

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

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

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

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

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

В консоли Configuration Manager перейдите в рабочую область Администрирование, разверните узел Конфигурация сайта и выберите Сайты.
Выберите Параметры иерархии на ленте.
На вкладке Общие включите параметр Расширения консоли, утвержденные иерархией, могут быть неподписанными .
По завершении нажмите кнопку ОК , чтобы закрыть свойства параметров иерархии.

Примечание.

В настоящее время, когда неподписаное расширение не включено для уведомления пользователя, в узле Расширения консоли столбец Обязательный остается пустым, а не заполняет значение 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 или более поздней)

Если у вас есть .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."}

Примечание.

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

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

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

В рабочей области Администрирование разверните узел Обновления и обслуживание, а затем выберите узел Расширения консоли.
Выберите Импорт расширения консоли на ленте или в контекстном меню.
Когда мастер запустится, нажмите кнопку Обзор и перейдите к CAB-файлу расширения.
При необходимости выберите параметр Разрешить отмену знака расширения.
Нажмите кнопку Далее , чтобы просмотреть сводку импорта, а затем завершите работу мастера импорта расширения.

Примечание.

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

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

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

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

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

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

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

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

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

Импорт расширения консоли без знака с помощью скрипта

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

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

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

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

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

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

Дополнительные ресурсы