Importera Configuration Manager konsoltillägg

Gäller för: Konfigurationshanteraren (current branch)

Från och med Configuration Manager 2103 kan du importera konsoltillägg som ska användas i din miljö. Dessa tillägg visas under noden Konsoltillägg . När du importerar och bara har tillägg i konsolen blir de inte omedelbart tillgängliga. En administratör måste fortfarande godkänna tillägget för webbplatsen och aktivera meddelanden. Sedan kan konsolanvändare installera tillägget till sin lokala konsol. Mer information om hur du hanterar och installerar konsoltillägg finns i Hantera Configuration Manager-konsoltillägg.

Olika importalternativ är tillgängliga baserat på versionen av Configuration Manager du kör. Inledningsvis kunde endast signerade tillägg importeras via administrationstjänsten. Stöd för att importera osignerade tillägg har lagts till senare. Sedan introducerades en guide som kunde importera både signerade och osignerade tillägg åt dig utan att du behöver köra ett skript i version 2111.

Importera konsoltillägg

Om du vill importera konsoltillägg följer du fyra grundläggande steg. Exakt hur du kan importera bestäms av vilken version av Configuration Manager du använder och om tillägget är signerat eller inte. För att importera och installera ett hierarkigodkänt konsoltillägg är de övergripande stegen:

1. Kontrollera om du behöver tillåta osignerade hierarkigodkända konsoltillägg (version 2107 och senare).
2. Importera konsoltillägget med någon av följande metoder:
   • Importera ett signerat konsoltillägg med ett skript (version 2103 och senare)
   • Importera ett osignerat konsoltillägg med ett skript (version 2107 och senare)
   • Använd guiden Importera konsoltillägg (version 2111 och senare)
3. Testa tillägget i en lokal konsol.
4. Aktivera meddelanden så att konsolanvändare kan installera konsoltillägget.

Tillåt osignerade konsoltillägg för hierarkin

(Gäller för Configuration Manager version 2107 eller senare)

Från och med Configuration Manager version 2107 kan du välja att tillåta osignerade hierarkigodkända konsoltillägg. Det är bästa praxis att alltid använda signerade tillägg för att minimera säkerhetsrisker och bekräfta äktheten hos ett konsoltillägg. I vissa fall kan du dock behöva tillåta osignerade konsoltillägg på grund av ett osignerat internt utvecklat tillägg eller för att testa ditt eget anpassade tillägg i ett labb. Om du vill tillåta import och installation av osignerade hierarkigodkända konsoltillägg aktiverar du en hierarkiinställning.

1. I Configuration Manager-konsolen går du till arbetsytan Administration, expanderar Platskonfiguration och väljer Platser.
2. Välj Hierarkiinställningar i menyfliksområdet.
3. På fliken Allmänt aktiverar du alternativet Hierarkigodkända konsoltillägg kan vara osignerat .
4. Välj OK när du är klar för att stänga egenskaperna för hierarkiinställningar.

Importera ett signerat konsoltillägg med ett skript

(Gäller för Configuration Manager version 2103 eller senare)

När du har ett tillägg paketerat i en signerad .cab fil kan du importera det till Configuration Manager. Du gör detta genom att publicera det via administrationstjänsten med hjälp av ett PowerShell-skript. När tillägget har infogats på platsen kan du godkänna och installera det lokalt från noden Konsoltillägg . Om du vill importera kör du följande PowerShell-skript när du har redigerat $adminServiceProvider och $cabFilePath:

• $adminServiceProvider – SMSProvider-servern på den översta nivån där administrationstjänsten är installerad
• $cabFilePath – Sökväg till tilläggets signerade .cab fil

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

Importera ett osignerat konsoltillägg med ett skript

(Gäller för Configuration Manager version 2107 eller senare)

Från och med Configuration Manager version 2107 kan du välja att tillåta osignerade hierarkigodkända konsoltillägg. Det är bästa praxis att alltid använda signerade tillägg för att minimera säkerhetsrisker och bekräfta äktheten hos ett konsoltillägg. I vissa fall kan du dock behöva tillåta osignerade konsoltillägg på grund av ett osignerat internt utvecklat tillägg eller för att testa ditt eget anpassade tillägg i ett labb.

När du har .cab filen för ett tillägg kan du testa den i en Configuration Manager labbmiljö. Du gör detta genom att publicera det via administrationstjänsten. När tillägget har infogats på platsen kan du godkänna det och installera det lokalt från noden Konsoltillägg . Om du vill importera kör du följande PowerShell-skript när du har redigerat $adminServiceProvider och $cabFilePath:

• $adminServiceProvider – SMSProvider-servern på den översta nivån där administrationstjänsten är installerad
• $cabFilePath– Sökväg till filnamnstillägget .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."}

Guiden Importera konsoltillägg

(Gäller för Configuration Manager version 2111 eller senare)

Från och med version 2111 kan du använda guiden Importera konsoltillägg för att importera konsoltillägg som hanteras för hierarkin. Du behöver inte längre använda ett PowerShell-skript för att importera ett signerat eller osignerat konsoltillägg. Så här importerar du ett konsoltillägg med hjälp av guiden:

1. Från arbetsytan Administration expanderar du Uppdateringar och Service och väljer sedan noden Konsoltillägg.
2. Välj Importera konsoltillägg i menyfliksområdet eller på högerklicksmenyn.
3. När guiden startas väljer du Bläddra och navigerar till tilläggets cab-fil.
4. Om det behövs väljer du alternativet Tillåt att tillägget är osignerat.
5. Välj Nästa för att granska importsammanfattningen och slutför sedan guiden för att importera tillägget.

Installera och testa ett tillägg på en lokal konsol

1. Ändra säkerhetsomfånget för tillägget. Vi rekommenderar att du ändrar säkerhetsomfånget för inledande testning av ett tillägg.

   1. Gå till noden Konsoltillägg underAdministrationsöversikt>>Uppdateringar och Service.
   2. Välj tillägget och välj sedan Ange säkerhetsomfattningar i menyfliksområdet.
   3. Ta bort standardsäkerhetsomfånget och lägg till ett omfång som bara innehåller en eller två administratörer för inledande testning.
   4. Välj OK för att spara säkerhetsomfattningen för tillägget.

2. Godkänn tillägget genom att välja Godkänn installation i menyfliksområdet eller högerklicka på menyn.

   • Om tillägget inte har godkänts kan du inte installera det eller aktivera meddelanden i konsolen för det.
   • Om du startar om konsolen nu visas inget meddelande om det tillgängliga tillägget eftersom du inte har aktiverat alternativet ännu.

3. Installera tillägget på den lokala konsolen genom att välja Installera.

4. När tillägget har installerats kontrollerar du att det visas och att du kan använda det från den lokala konsolen.

Aktivera användarmeddelanden för tilläggsinstallation

1. Om det behövs ändrar du säkerhetsomfattningarna för tillägget för att tillåta åtkomst av fler administratörer. Dessa administratörer kommer att riktas mot meddelandet i konsolen för att installera tillägget.
2. Välj Aktivera meddelanden.
3. Starta en Configuration Manager-konsol som inte har tillägget installerat. Vi rekommenderar att du använder ett testkonto som du gav åtkomst till när du ändrade säkerhetsomfånget.
4. Kontrollera att meddelandet för tillägget inträffar och att du kan installera tillägget.

Nästa steg

• Hantera konsoltillägg
• Konsoltillägg från Community Hub
• Utveckla anpassade konsoltillägg