Importowanie rozszerzeń konsoli Configuration Manager

Dotyczy: programu Configuration Manager (bieżąca gałąź)

Począwszy od Configuration Manager 2103 roku, możesz zaimportować rozszerzenia konsoli do użycia w środowisku. Te rozszerzenia są wyświetlane w węźle Rozszerzenia konsoli . Importowanie i po prostu posiadanie rozszerzeń w konsoli nie powoduje ich natychmiastowego udostępnienia. Administrator musi jeszcze zatwierdzić rozszerzenie witryny i włączyć powiadomienia. Następnie użytkownicy konsoli mogą zainstalować rozszerzenie w konsoli lokalnej. Aby uzyskać więcej informacji na temat zarządzania rozszerzeniami konsoli i instalowania ich, zobacz Zarządzanie rozszerzeniami konsoli Configuration Manager.

W zależności od wersji Configuration Manager, w której korzystasz, dostępne są różne opcje importowania. Początkowo tylko podpisane rozszerzenia mogą być importowane za pośrednictwem usługi administracyjnej. Obsługa importowania niepodpisanych rozszerzeń została dodana później. Następnie kreator, który może zaimportować zarówno podpisane, jak i niepodpisane rozszerzenia bez konieczności uruchamiania skryptu, został wprowadzony w wersji 2111.

Wersja programu Configuration Manager	2103	2107	2111 lub nowszy
Importowanie podpisanego rozszerzenia	Tak	Tak	Tak
Importowanie niepodpisanego rozszerzenia	Nie	Tak, gdy zezwalasz na niepodpisane	Tak, gdy zezwalasz na niepodpisane
Importowanie z usługi administracyjnej za pomocą skryptu programu PowerShell	Tak, tylko podpisane rozszerzenia	Tak	Tak
Importowanie z kreatora importowania rozszerzenia konsoli	Nie	Nie	Tak

Jak importować rozszerzenia konsoli

Aby zaimportować rozszerzenia konsoli, wykonaj cztery podstawowe kroki. Dokładnie, jak można zaimportować, będzie zależeć od wersji Configuration Manager, której używasz, i czy rozszerzenie jest podpisane, czy nie. Aby zaimportować i zainstalować rozszerzenie konsoli zatwierdzone przez hierarchię, kroki wysokiego poziomu są następujące:

1. Określ, czy chcesz zezwolić na niepodpisane rozszerzenia konsoli zatwierdzone przez hierarchię (wersja 2107 i nowsze).
2. Zaimportuj rozszerzenie konsoli przy użyciu jednej z następujących metod:
   • Importowanie podpisanego rozszerzenia konsoli za pomocą skryptu (wersja 2103 i nowsze)
   • Importowanie niepodpisanego rozszerzenia konsoli za pomocą skryptu (wersja 2107 i nowsze)
   • Użyj kreatora importowania rozszerzenia konsoli (wersja 2111 lub nowsza)
3. Przetestuj rozszerzenie w konsoli lokalnej.
4. Włącz powiadomienia , aby umożliwić użytkownikom konsoli instalowanie rozszerzenia konsoli.

Zezwalaj na niepodpisane rozszerzenia konsoli dla hierarchii

(Dotyczy Configuration Manager wersji 2107 lub nowszej)

Począwszy od Configuration Manager wersji 2107, możesz zezwolić na niepodpisane rozszerzenia konsoli zatwierdzone przez hierarchię. Najlepszym rozwiązaniem jest, aby zawsze używać podpisanych rozszerzeń w celu zminimalizowania zagrożeń bezpieczeństwa i potwierdzenia autentyczności rozszerzenia konsoli. Jednak w niektórych przypadkach może być konieczne zezwolenie na niepodpisane rozszerzenia konsoli z powodu niepodpisanego rozszerzenia opracowanego wewnętrznie lub testowanie własnego rozszerzenia niestandardowego w laboratorium. Aby zezwolić na importowanie i instalowanie niepodpisanych rozszerzeń konsoli zatwierdzonych przez hierarchię, włączysz ustawienie hierarchii.

1. W konsoli Configuration Manager przejdź do obszaru roboczego Administracja, rozwiń węzeł Konfiguracja lokacji i wybierz pozycję Lokacje.
2. Wybierz pozycję Ustawienia hierarchii na wstążce.
3. Na karcie Ogólne włącz opcję Niepodpisane rozszerzenia konsoli zatwierdzone przez hierarchię .
4. Po zakończeniu wybierz przycisk OK , aby zamknąć właściwości ustawień hierarchii.

Uwaga

Obecnie, gdy niepodpisane rozszerzenie nie jest włączone dla powiadomień użytkownika, w węźle Rozszerzenia konsolikolumna Wymagane pozostaje pusta, zamiast wypełniać wartość Nie.

Importowanie podpisanego rozszerzenia konsoli za pomocą skryptu

(Dotyczy Configuration Manager wersji 2103 lub nowszej)

Jeśli masz rozszerzenie spakowane w podpisanym .cab pliku, możesz zaimportować je do Configuration Manager. Zrobisz to, publikując go za pośrednictwem usługi administracyjnej przy użyciu skryptu programu PowerShell. Po wstawieniu rozszerzenia do lokacji można je zatwierdzić i zainstalować lokalnie z poziomu węzła Rozszerzenia konsoli . Aby zaimportować, uruchom następujący skrypt programu PowerShell po edycji elementów $adminServiceProvider i $cabFilePath:

• $adminServiceProvider — serwer SMSProvider najwyższego poziomu, na którym jest zainstalowana usługa administracyjna
• $cabFilePath — Ścieżka do podpisanego .cab pliku rozszerzenia

$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."}

Importowanie niepodpisanego rozszerzenia konsoli za pomocą skryptu

(Dotyczy Configuration Manager wersji 2107 lub nowszej)

Począwszy od Configuration Manager wersji 2107, możesz zezwolić na niepodpisane rozszerzenia konsoli zatwierdzone przez hierarchię. Najlepszym rozwiązaniem jest, aby zawsze używać podpisanych rozszerzeń w celu zminimalizowania zagrożeń bezpieczeństwa i potwierdzenia autentyczności rozszerzenia konsoli. Jednak w niektórych przypadkach może być konieczne zezwolenie na niepodpisane rozszerzenia konsoli z powodu niepodpisanego rozszerzenia opracowanego wewnętrznie lub testowanie własnego rozszerzenia niestandardowego w laboratorium.

Jeśli masz .cab plik rozszerzenia, możesz go przetestować w środowisku laboratorium Configuration Manager. Zrobisz to, publikując go za pośrednictwem usługi administracyjnej. Po wstawieniu rozszerzenia do lokacji można je zatwierdzić i zainstalować lokalnie z poziomu węzła Rozszerzenia konsoli . Aby zaimportować, uruchom następujący skrypt programu PowerShell po edycji elementów $adminServiceProvider i $cabFilePath:

• $adminServiceProvider — serwer SMSProvider najwyższego poziomu, na którym jest zainstalowana usługa administracyjna
• $cabFilePath- Ścieżka do pliku rozszerzenia .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."}

Uwaga

Obecnie, gdy niepodpisane rozszerzenie nie jest włączone dla powiadomień użytkownika, w węźle Rozszerzenia konsolikolumna Wymagane pozostaje pusta, zamiast wypełniać wartość Nie.

Kreator importowania rozszerzeń konsoli

(Dotyczy Configuration Manager wersji 2111 lub nowszej)

Począwszy od wersji 2111, możesz użyć kreatora importu rozszerzenia konsoli , aby zaimportować rozszerzenia konsoli zarządzane dla hierarchii. Nie trzeba już używać skryptu programu PowerShell do importowania podpisanego lub niepodpisanego rozszerzenia konsoli. Aby zaimportować rozszerzenie konsoli przy użyciu kreatora:

1. W obszarze roboczym Administracja rozwiń węzeł Aktualizacje i obsługa, a następnie wybierz węzeł Rozszerzenia konsoli.
2. Wybierz pozycję Importuj rozszerzenie konsoli na wstążce lub w menu kliknij prawym przyciskiem myszy.
3. Po uruchomieniu kreatora wybierz pozycję Przeglądaj i przejdź do pliku cab rozszerzenia.
4. W razie potrzeby wybierz opcję Zezwalaj na niepodpisanie rozszerzenia.
5. Wybierz pozycję Dalej , aby przejrzeć podsumowanie importu, a następnie ukończ pracę kreatora, aby zaimportować rozszerzenie.

Uwaga

Aby zaimportować niepodpisane rozszerzenia, w ustawieniach hierarchii należy włączyć opcję Rozszerzenia konsoli zatwierdzone przez hierarchię. Aby uzyskać więcej informacji, zobacz Zezwalaj na niepodpisane rozszerzenia konsoli zatwierdzone przez hierarchię.

Instalowanie i testowanie rozszerzenia w konsoli lokalnej

1. Zmień zakres zabezpieczeń rozszerzenia. Zmiana zakresu zabezpieczeń jest zalecana do wstępnego testowania rozszerzenia.

   1. Przejdź do węzła Rozszerzenia konsoli w obszarze Administracja>— omówienie>Aktualizacje i obsługa.
   2. Wybierz rozszerzenie, a następnie wybierz pozycję Ustaw zakresy zabezpieczeń na wstążce.
   3. Usuń domyślny zakres zabezpieczeń i dodaj zakres zawierający tylko jednego lub dwóch administratorów do wstępnego testowania.
   4. Wybierz przycisk OK , aby zapisać zakres zabezpieczeń rozszerzenia.

2. Zatwierdź rozszerzenie, wybierając pozycję Zatwierdź instalację na wstążce lub kliknij prawym przyciskiem myszy menu.

   • Jeśli rozszerzenie nie zostanie zatwierdzone, nie będzie można go zainstalować ani włączyć dla niego powiadomień w konsoli.
   • Jeśli w tym momencie ponownie uruchomisz konsolę, powiadomienie o dostępnym rozszerzeniu nie zostanie wyświetlone, ponieważ opcja nie została jeszcze włączona.

3. Zainstaluj rozszerzenie w konsoli lokalnej, wybierając pozycję Zainstaluj.

4. Po zainstalowaniu rozszerzenia sprawdź, czy jest ono wyświetlane i można go używać z poziomu konsoli lokalnej.

Włączanie powiadomień użytkowników dotyczących instalacji rozszerzenia

1. W razie potrzeby zmodyfikuj zakresy zabezpieczeń rozszerzenia, aby umożliwić dostęp większej liczby administratorów. Ci administratorzy będą objęci powiadomieniem w konsoli na potrzeby instalowania rozszerzenia.
2. Wybierz pozycję Włącz powiadomienia.
3. Uruchom konsolę Configuration Manager, która nie ma zainstalowanego rozszerzenia. Najlepiej użyć konta testowego, do którego udzielono dostępu podczas modyfikowania zakresu zabezpieczeń.
4. Sprawdź, czy zostanie wyświetlone powiadomienie o rozszerzeniu i czy możesz zainstalować rozszerzenie.

Następne kroki

• Zarządzanie rozszerzeniami konsoli
• Rozszerzenia konsoli z centrum Community Hub
• Tworzenie niestandardowych rozszerzeń konsoli