Sdílet prostřednictvím

Import rozšíření konzoly Configuration Manager

  • Článek

Platí pro: Configuration Manager (Current Branch)

Od Configuration Manager 2103 můžete importovat rozšíření konzoly pro použití ve vašem prostředí. Tato rozšíření se zobrazí v uzlu Rozšíření konzoly . Importem a pouhým používáním rozšíření v konzole nedojde k jejich okamžitému zpřístupnění. Správce stále musí schválit rozšíření webu a povolit oznámení. Uživatelé konzoly pak můžou rozšíření nainstalovat do své místní konzoly. Další informace o správě a instalaci rozšíření konzoly najdete v tématu Správa rozšíření konzoly Configuration Manager.

V závislosti na verzi Configuration Manager, kterou používáte, jsou k dispozici různé možnosti importu. Zpočátku bylo možné prostřednictvím služby pro správu importovat jenom podepsaná rozšíření. Podpora importu nepodepsaných rozšíření byla přidána později. Potom byl ve verzi 2111 zaveden průvodce, který by mohl importovat podepsaná i nepodepsaná rozšíření bez nutnosti spouštět skript.

Verze nástroje Configuration Manager 2103 2107 2111 nebo novější
Import podepsaného rozšíření Ano Ano Ano
Import nepodepsaného rozšíření Ne Ano, když povolíte nepodepsané Ano, když povolíte nepodepsané
Import ze služby pro správu pomocí skriptu PowerShellu Ano, jenom podepsaná rozšíření Ano Ano
Import z průvodce importem rozšíření konzoly Ne Ne Ano

Import rozšíření konzoly

Pokud chcete importovat rozšíření konzoly, postupujte podle čtyř základních kroků. Přesný způsob importu určuje verze Configuration Manager, kterou používáte, a jestli je rozšíření podepsané nebo ne. Pokud chcete importovat a nainstalovat rozšíření konzoly schválené hierarchií, postupujte takto:

  1. Zjistěte, jestli potřebujete povolit rozšíření konzoly schválená pro nepodepsanou hierarchii (verze 2107 a novější).
  2. Naimportujte rozšíření konzoly pomocí jedné z následujících metod:
  3. Otestujte rozšíření v místní konzole.
  4. Povolte oznámení , aby si uživatelé konzoly mohli nainstalovat rozšíření konzoly.

Povolit nepodepsaná rozšíření konzoly pro hierarchii

(Platí pro Configuration Manager verze 2107 nebo novější.)

Od Configuration Manager verze 2107 můžete povolit nepodepsaná rozšíření konzoly schválená hierarchií. Osvědčeným postupem je vždy používat podepsaná rozšíření, abyste minimalizovali bezpečnostní rizika a ověřili pravost rozšíření konzoly. V některých případech ale může být nutné povolit nepodepsaná rozšíření konzoly kvůli nepodepsaným interně vyvinutým rozšířením nebo k testování vlastního rozšíření v testovacím prostředí. Pokud chcete povolit import a instalaci nepodepsaných rozšíření konzoly schválených pro hierarchii, povolíte nastavení hierarchie.

  1. V konzole Configuration Manager přejděte do pracovního prostoru Správa, rozbalte Položku Konfigurace lokality a vyberte Lokality.
  2. Na pásu karet vyberte Nastavení hierarchie .
  3. Na kartě Obecné povolte možnost Rozšíření konzoly schválená hierarchií mohou být nepodepsaná .
  4. Po dokončení vyberte OK a zavřete vlastnosti nastavení hierarchie.

Poznámka

Pokud v současné době není povolené oznámení uživatele u nepodepsaného rozšíření, zůstane sloupec Povinné v uzlu Rozšíření konzoly prázdný místo naplnění hodnoty Ne.

Import podepsaného rozšíření konzoly pomocí skriptu

(Platí pro Configuration Manager verze 2103 nebo novější.)

Pokud máte ve podepsaném .cab souboru zabalenou příponu, můžete ji importovat do Configuration Manager. Provedete to tak, že ho publikujete prostřednictvím služby pro správu pomocí skriptu PowerShellu. Po vložení rozšíření do lokality ho můžete schválit a nainstalovat místně z uzlu Rozšíření konzoly . Pokud chcete importovat, spusťte následující skript PowerShellu po úpravě $adminServiceProvider a $cabFilePath:

  • $adminServiceProvider – Server SMSProvider nejvyšší úrovně, na kterém je nainstalovaná služba správy
  • $cabFilePath - Cesta k podepsanému .cab souboru rozšíření
$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."}

Import nepodepsaného rozšíření konzoly pomocí skriptu

(Platí pro Configuration Manager verze 2107 nebo novější.)

Od Configuration Manager verze 2107 můžete povolit nepodepsaná rozšíření konzoly schválená hierarchií. Osvědčeným postupem je vždy používat podepsaná rozšíření, abyste minimalizovali bezpečnostní rizika a ověřili pravost rozšíření konzoly. V některých případech ale může být nutné povolit nepodepsaná rozšíření konzoly kvůli nepodepsaným interně vyvinutým rozšířením nebo k testování vlastního rozšíření v testovacím prostředí.

Pokud máte soubor pro příponu.cab, můžete ho otestovat v Configuration Manager testovacím prostředí. Uděláte to tak, že ho zveřejníte prostřednictvím služby správy. Po vložení rozšíření do lokality ho můžete schválit a nainstalovat místně z uzlu Rozšíření konzoly . Pokud chcete importovat, spusťte následující skript PowerShellu po úpravě $adminServiceProvider a $cabFilePath:

  • $adminServiceProvider – Server SMSProvider nejvyšší úrovně, na kterém je nainstalovaná služba správy
  • $cabFilePath- Cesta k souboru přípony .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."}

Poznámka

Pokud v současné době není povolené oznámení uživatele u nepodepsaného rozšíření, zůstane sloupec Povinné v uzlu Rozšíření konzoly prázdný místo naplnění hodnoty Ne.

Průvodce importem rozšíření konzoly

(Platí pro Configuration Manager verze 2111 nebo novější.)

Od verze 2111 můžete pomocí průvodce importem rozšíření konzoly importovat rozšíření konzoly , která jsou spravovaná pro hierarchii. K importu podepsaného nebo nepodepsaného rozšíření konzoly už nemusíte používat skript PowerShellu. Import rozšíření konzoly pomocí průvodce:

  1. V pracovním prostoru Správa rozbalte Aktualizace a Údržba a pak vyberte uzel Rozšíření konzoly.
  2. Na pásu karet nebo v nabídce po kliknutí pravým tlačítkem vyberte Importovat rozšíření konzoly .
  3. Po spuštění průvodce vyberte Procházet a přejděte na soubor CAB rozšíření.
  4. V případě potřeby vyberte možnost Povolit zrušení znaménka rozšíření.
  5. Výběrem možnosti Další zkontrolujte souhrn importu a pak dokončete průvodce importem rozšíření.

Poznámka

Pokud chcete importovat nepodepsaná rozšíření, musí být v nastavení hierarchie povolená možnost Rozšíření konzoly schválená hierarchií bez znaménka. Další informace najdete v tématu Povolení rozšíření konzoly schválených pro nepodepsané hierarchie.

Instalace a testování rozšíření v místní konzole

  1. Změňte obor zabezpečení pro rozšíření. Změna rozsahu zabezpečení se doporučuje pro počáteční testování rozšíření.

    1. Přejděte do uzlu Rozšíření konzoly v částiPřehled>správy>Aktualizace a údržba.
    2. Vyberte rozšíření a pak na pásu karet vyberte Nastavit obory zabezpečení .
    3. Odeberte výchozí obor zabezpečení a přidejte obor, který obsahuje jenom jednoho nebo dva správce pro počáteční testování.
    4. Zvolte OK a uložte rozsah zabezpečení rozšíření.

  2. Rozšíření schválíte tak, že na pásu karet nebo v nabídce po kliknutí pravým tlačítkem vyberete Schválit instalaci .

    • Pokud rozšíření není schválené, nebudete ho moct nainstalovat ani pro něj povolit oznámení v konzole.
    • Pokud konzolu restartujete v tomto okamžiku, oznámení o dostupném rozšíření se nezobrazí, protože jste tuto možnost ještě nepovolili.

  3. Nainstalujte rozšíření do místní konzoly tak, že zvolíte Nainstalovat.

  4. Po instalaci rozšíření ověřte, že se zobrazuje a můžete ho použít z místní konzoly.

Povolení oznámení uživatelů pro instalaci rozšíření

  1. V případě potřeby upravte obory zabezpečení pro rozšíření tak, aby přístup povolily více správcům. Tito správci budou zacílit oznámením v konzole pro instalaci rozšíření.
  2. Vyberte Povolit oznámení.
  3. Spusťte Configuration Manager konzolu, ve které není nainstalované rozšíření. V ideálním případě použijte testovací účet, ke kterému jste udělili přístup při úpravě oboru zabezpečení.
  4. Ověřte, že se zobrazí oznámení o rozšíření a že můžete rozšíření nainstalovat.

Další kroky