Importar extensões de console Configuration Manager

Aplica-se a: Gerenciador de Configurações (branch atual)

A partir de Configuration Manager 2103, você pode importar extensões de console para serem usadas em seu ambiente. Essas extensões aparecem no nó Extensões do Console . Importar e apenas ter extensões no console não as disponibiliza imediatamente. Um administrador ainda precisa aprovar a extensão do site e habilitar notificações. Em seguida, os usuários do console podem instalar a extensão no console local. Para obter mais informações sobre como gerenciar e instalar extensões de console, consulte Gerenciar extensões de console Configuration Manager.

Com base na versão do Configuration Manager que você está executando, diferentes opções de importação estão disponíveis. Inicialmente, somente extensões assinadas poderiam ser importadas por meio do serviço de administração. O suporte para importar extensões não assinadas foi adicionado posteriormente. Em seguida, um assistente que poderia importar extensões assinadas e não assinadas para você sem precisar executar um script foi introduzido na versão 2111.

Versão do Gerenciador de Configurações	2103	2107	2111 ou posterior
Importar uma extensão assinada	Sim	Sim	Sim
Importar uma extensão não assinada	Não	Sim, quando você permitir sem sinal	Sim, quando você permitir sem sinal
Importar do serviço de administração com um script do PowerShell	Sim, somente extensões assinadas	Sim	Sim
Importar do assistente Importar Extensão do Console	Não	Não	Sim

Como importar extensões de console

Para importar extensões de console, você seguirá quatro etapas básicas. Exatamente como você pode importar será determinado pela versão de Configuration Manager você está usando e se a extensão está assinada ou não. Para importar e instalar uma extensão de console aprovada pela hierarquia, as etapas de alto nível são:

1. Determine se você precisa permitir extensões de console aprovadas por hierarquia não assinada (versão 2107 e posterior).
2. Importe a extensão do console usando um dos seguintes métodos:
   • Importar uma extensão de console assinada com um script (versão 2103 e posterior)
   • Importar uma extensão de console não assinada com um script (versão 2107 e posterior)
   • Use o assistente Importar Extensão do Console (versão 2111 e posterior)
3. Teste a extensão em um console local.
4. Habilite as notificações para permitir que os usuários do console instalem a extensão do console.

Permitir extensões de console não assinadas para a hierarquia

(Aplica-se a Configuration Manager versão 2107 ou posterior)

A partir de Configuration Manager versão 2107, você pode optar por permitir extensões de console aprovadas por hierarquia não assinada. É uma prática recomendada sempre usar extensões assinadas para minimizar os riscos de segurança e confirmar a autenticidade de uma extensão de console. No entanto, em alguns casos, talvez seja necessário permitir extensões de console não assinadas devido a uma extensão não assinada internamente ou para testar sua própria extensão personalizada em um laboratório. Para permitir a importação e a instalação de extensões de console aprovadas pela hierarquia não assinada, você habilitará uma configuração de hierarquia.

1. No console Configuration Manager, acesse o workspace Administração, expanda Configuração do Site e selecione Sites.
2. Selecione Configurações de Hierarquia na faixa de opções.
3. Na guia Geral , habilite a opção Extensões de console aprovadas pela Hierarquia .
4. Selecione Ok quando for feito para fechar as propriedades configurações de hierarquia.

Observação

Atualmente, quando uma extensão não assinada não está habilitada para notificação do usuário, no nó Extensões do Console , a coluna Obrigatório permanece em branco em vez de preencher um valor de Não.

Importar uma extensão de console assinada com um script

(Aplica-se a Configuration Manager versão 2103 ou posterior)

Quando você tem uma extensão empacotada em um arquivo assinado.cab, você pode importá-la para Configuration Manager. Você fará isso postando-o por meio do serviço de administração usando um script do PowerShell. Depois que a extensão for inserida no site, você poderá aprová-la e instalá-la localmente no nó Extensões do Console . Para importar, execute o seguinte script do PowerShell depois de editar o $adminServiceProvider e $cabFilePath:

• $adminServiceProvider - O servidor SMSProvider de nível superior em que o serviço de administração está instalado
• $cabFilePath - Caminho para o arquivo assinado .cab da extensão

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

Importar uma extensão de console não assinada com um script

(Aplica-se a Configuration Manager versão 2107 ou posterior)

A partir de Configuration Manager versão 2107, você pode optar por permitir extensões de console aprovadas por hierarquia não assinada. É uma prática recomendada sempre usar extensões assinadas para minimizar os riscos de segurança e confirmar a autenticidade de uma extensão de console. No entanto, em alguns casos, talvez seja necessário permitir extensões de console não assinadas devido a uma extensão não assinada internamente ou para testar sua própria extensão personalizada em um laboratório.

Quando você tiver o .cab arquivo para uma extensão, você pode testá-lo em um ambiente de laboratório Configuration Manager. Você fará isso postando-o por meio do serviço de administração. Depois que a extensão for inserida no site, você poderá aprová-la e instalá-la localmente no nó Extensões do Console . Para importar, execute o seguinte script do PowerShell depois de editar o $adminServiceProvider e $cabFilePath:

• $adminServiceProvider - O servidor SMSProvider de nível superior em que o serviço de administração está instalado
• $cabFilePath - Caminho para o arquivo da .cab extensão

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

Observação

Atualmente, quando uma extensão não assinada não está habilitada para notificação do usuário, no nó Extensões do Console , a coluna Obrigatório permanece em branco em vez de preencher um valor de Não.

Assistente de importação de extensões de console

(Aplica-se a Configuration Manager versão 2111 ou posterior)

A partir da versão 2111, você pode usar o assistente Importar Extensão de Console para importar extensões de console gerenciadas para a hierarquia. Você não precisa mais usar um script do PowerShell para importar uma extensão de console assinada ou não assinada. Para importar uma extensão de console usando o assistente:

1. No workspace Administração, expanda Atualizações e Manutenção e selecione o nó Extensões do Console.
2. Selecione Importar Extensão de Console na faixa de opções ou no menu com o botão direito do mouse.
3. Quando o assistente for iniciado, selecione Procurar e navegue até o arquivo de táxi da extensão.
4. Se necessário, selecione a opção Permitir que a extensão não seja assinada.
5. Selecione Avançar para examinar o resumo de importação e, em seguida, conclua o assistente para importar a extensão.

Observação

Para importar extensões não assinadas, as extensões de console aprovadas pela Hierarquia podem ser não assinadas e precisam ser habilitadas nas Configurações de Hierarquia. Para obter mais informações, consulte Permitir extensões de console aprovadas por hierarquia não assinada.

Instalar e testar uma extensão em um console local

1. Altere o escopo de segurança da extensão. A alteração do escopo de segurança é recomendada para o teste inicial de uma extensão.

   1. Acesse o nó Extensões de Console emVisão Geral> da Administração>Atualizações e Manutenção.
   2. Selecione a extensão e selecione Definir Escopos de Segurança na faixa de opções.
   3. Remova o escopo de segurança padrão e adicione um escopo que contém apenas um ou dois administradores para testes iniciais.
   4. Escolha OK para salvar o escopo de segurança da extensão.

2. Aprove a extensão selecionando Aprovar Instalação no menu faixa de opções ou clique com o botão direito do mouse.

   • Se a extensão não for aprovada, você não poderá instalá-la ou habilitar notificações no console para ela.
   • Se você reiniciar o console neste momento, uma notificação sobre a extensão disponível não ocorrerá, pois você ainda não habilitou a opção.

3. Instale a extensão no console local escolhendo Instalar.

4. Depois que a extensão for instalada, verifique se ela é exibida e você pode usá-la no console local.

Habilitar notificações de usuário para instalação de extensão

1. Se necessário, modifique os escopos de segurança da extensão para permitir o acesso de mais administradores. Esses administradores serão direcionados com a notificação no console para instalar a extensão.
2. Selecione Habilitar Notificações.
3. Inicie um console Configuration Manager que não tenha a extensão instalada. Idealmente, use uma conta de teste à qual você deu acesso quando modificou o escopo de segurança.
4. Verifique se a notificação da extensão ocorre e se você pode instalar a extensão.

Próximas etapas

• Gerenciar extensões de console
• Extensões de console do Hub comunitário
• Desenvolver extensões de console personalizadas