Importare Configuration Manager estensioni della console

  • Articolo

Si applica a: Configuration Manager (Current Branch)

A partire da Configuration Manager 2103, è possibile importare le estensioni della console da usare nell'ambiente. Queste estensioni vengono visualizzate nel nodo Estensioni della console . L'importazione e la presenza di estensioni nella console non le rendono immediatamente disponibili. Un amministratore deve comunque approvare l'estensione per il sito e abilitare le notifiche. Gli utenti della console possono quindi installare l'estensione nella console locale. Per altre informazioni sulla gestione e l'installazione delle estensioni della console, vedere Gestire le estensioni della console Configuration Manager.

In base alla versione di Configuration Manager in esecuzione, sono disponibili diverse opzioni di importazione. Inizialmente, solo le estensioni firmate potevano essere importate tramite il servizio di amministrazione. Il supporto per l'importazione di estensioni non firmate è stato aggiunto in un secondo momento. Nella versione 2111 è stata quindi introdotta una procedura guidata che poteva importare automaticamente sia le estensioni firmate che non firmate senza dover eseguire uno script.

Versione di Configuration Manager 2103 2107 2111 o versione successiva
Importare un'estensione firmata Sì Sì Sì
Importare un'estensione non firmata No Sì, quando si consente unsigned Sì, quando si consente unsigned
Importare dal servizio di amministrazione con uno script di PowerShell Sì, solo estensioni firmate Sì Sì
Importare dalla procedura guidata Importa estensione console No No Sì

Come importare le estensioni della console

Per importare le estensioni della console, seguirete quattro passaggi di base. Il modo esatto in cui è possibile importare verrà determinato dalla versione di Configuration Manager in uso e se l'estensione è firmata o meno. Per importare e installare un'estensione console approvata dalla gerarchia, i passaggi generali sono:

  1. Determinare se è necessario consentire le estensioni della console approvate dalla gerarchia non firmata (versione 2107 e successive).
  2. Importare l'estensione della console usando uno dei metodi seguenti:
  3. Testare l'estensione in una console locale.
  4. Abilitare le notifiche per consentire agli utenti della console di installare l'estensione della console.

Consenti estensioni della console non firmate per la gerarchia

(Si applica a Configuration Manager versione 2107 o successiva)

A partire da Configuration Manager versione 2107, è possibile scegliere di consentire le estensioni della console approvate della gerarchia non firmata. È consigliabile usare sempre le estensioni firmate per ridurre al minimo i rischi per la sicurezza e confermare l'autenticità di un'estensione della console. In alcuni casi, tuttavia, potrebbe essere necessario consentire le estensioni della console non firmate a causa di un'estensione non firmata sviluppata internamente o per testare la propria estensione personalizzata in un lab. Per consentire l'importazione e l'installazione di estensioni della console approvate dalla gerarchia non firmata, si abiliterà un'impostazione di gerarchia.

  1. Nella console Configuration Manager passare all'area di lavoro Amministrazione, espandere Configurazione sito e selezionare Siti.
  2. Selezionare Impostazioni gerarchia sulla barra multifunzione.
  3. Nella scheda Generale abilitare l'opzione Hierarchy approved console extensions can be unsigned (Le estensioni della console approvate dalla gerarchia possono essere senza segno ).
  4. Al termine, selezionare OK per chiudere le proprietà delle impostazioni della gerarchia.

Nota

Attualmente, quando un'estensione non firmata non è abilitata per la notifica dell'utente, nel nodo Estensioni della console la colonna Required rimane vuota invece di popolare un valore di No.

Importare un'estensione della console firmata con uno script

(Si applica a Configuration Manager versione 2103 o successiva)

Quando un'estensione è inserita in un pacchetto in un file firmato.cab, è possibile importarla in Configuration Manager. A tale scopo, è possibile pubblicarlo tramite il servizio di amministrazione usando uno script di PowerShell. Dopo aver inserito l'estensione nel sito, è possibile approvarla e installarla in locale dal nodo Estensioni della console . Per importare, eseguire lo script di PowerShell seguente dopo aver $adminServiceProvider modificato e $cabFilePath:

  • $adminServiceProvider - Server SMSProvider di primo livello in cui è installato il servizio di amministrazione
  • $cabFilePath - Percorso del file firmato .cab dell'estensione
$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."}

Importare un'estensione della console non firmata con uno script

(Si applica a Configuration Manager versione 2107 o successiva)

A partire da Configuration Manager versione 2107, è possibile scegliere di consentire le estensioni della console approvate della gerarchia non firmata. È consigliabile usare sempre le estensioni firmate per ridurre al minimo i rischi per la sicurezza e confermare l'autenticità di un'estensione della console. In alcuni casi, tuttavia, potrebbe essere necessario consentire le estensioni della console non firmate a causa di un'estensione non firmata sviluppata internamente o per testare la propria estensione personalizzata in un lab.

Quando si dispone del .cab file per un'estensione, è possibile testarlo in un ambiente lab Configuration Manager. A tale scopo, è possibile pubblicarlo tramite il servizio di amministrazione. Dopo aver inserito l'estensione nel sito, è possibile approvarla e installarla in locale dal nodo Estensioni della console . Per importare, eseguire lo script di PowerShell seguente dopo aver $adminServiceProvider modificato e $cabFilePath:

  • $adminServiceProvider - Server SMSProvider di primo livello in cui è installato il servizio di amministrazione
  • $cabFilePath- Percorso del file dell'estensione .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."}

Nota

Attualmente, quando un'estensione non firmata non è abilitata per la notifica dell'utente, nel nodo Estensioni della console la colonna Required rimane vuota invece di popolare un valore di No.

Importazione guidata estensioni della console

(Si applica a Configuration Manager versione 2111 o successiva)

A partire dalla versione 2111, è possibile usare l'Importazione guidata estensione console per importare le estensioni della console gestite per la gerarchia. Non è più necessario usare uno script di PowerShell per importare un'estensione della console firmata o non firmata. Per importare un'estensione della console tramite la procedura guidata:

  1. Nell'area di lavoro Amministrazione espandere Aggiornamenti e Manutenzione, quindi selezionare il nodo Estensioni console.
  2. Selezionare Importa estensione console dalla barra multifunzione o dal menu di scelta rapida.
  3. All'avvio della procedura guidata selezionare Sfoglia e passare al file CAB dell'estensione.
  4. Se necessario, selezionare l'opzione Consenti l'annullamento del segno dell'estensione.
  5. Selezionare Avanti per esaminare il riepilogo dell'importazione, quindi completare la procedura guidata per importare l'estensione.

Nota

Per importare estensioni non firmate, l'opzione Hierarchy approved console extensions can be unsigned (Estensioni della console approvate dalla gerarchia) deve essere abilitata in Impostazioni gerarchia. Per altre informazioni, vedere Consenti estensioni della console approvate per gerarchia non firmata.

Installare e testare un'estensione in una console locale

  1. Modificare l'ambito di sicurezza per l'estensione. La modifica dell'ambito di sicurezza è consigliata per il test iniziale di un'estensione.

    1. Passare al nodo Estensioni della console inPanoramica>dell'amministrazione>Aggiornamenti e manutenzione.
    2. Selezionare l'estensione, quindi selezionare Imposta ambiti di sicurezza dalla barra multifunzione.
    3. Rimuovere l'ambito di sicurezza Predefinito e aggiungere un ambito che contiene solo uno o due amministratori per il test iniziale.
    4. Scegliere OK per salvare l'ambito di sicurezza per l'estensione.

  2. Approvare l'estensione selezionando Approva installazione dalla barra multifunzione o facendo clic con il pulsante destro del mouse.

    • Se l'estensione non è approvata, non sarà possibile installarla o abilitarne le notifiche nella console.
    • Se si riavvia la console a questo punto, non verrà visualizzata una notifica sull'estensione disponibile perché l'opzione non è ancora stata abilitata.

  3. Installare l'estensione nella console locale scegliendo Installa.

  4. Dopo aver installato l'estensione, verificare che venga visualizzata ed è possibile usarla dalla console locale.

Abilitare le notifiche utente per l'installazione dell'estensione

  1. Se necessario, modificare gli ambiti di sicurezza per l'estensione per consentire l'accesso da parte di altri amministratori. Questi amministratori verranno assegnati alla notifica nella console per l'installazione dell'estensione.
  2. Selezionare Abilita notifiche.
  3. Avviare una console di Configuration Manager in cui non è installata l'estensione. In teoria, usare un account di test a cui è stato assegnato l'accesso quando è stato modificato l'ambito di sicurezza.
  4. Verificare che la notifica per l'estensione si verifichi e che sia possibile installare l'estensione.

Passaggi successivi