Comparteix a través de

Importación de extensiones de consola de Configuration Manager

  • Article

Se aplica a: Configuration Manager (rama actual)

A partir de Configuration Manager 2103, puede importar extensiones de consola para usarlas en su entorno. Estas extensiones se muestran en el nodo Extensiones de consola . La importación y el solo tener extensiones en la consola no hace que estén disponibles inmediatamente. Un administrador todavía tiene que aprobar la extensión para el sitio y habilitar las notificaciones. A continuación, los usuarios de la consola pueden instalar la extensión en su consola local. Para obtener más información sobre cómo administrar e instalar extensiones de consola, consulte Administración de extensiones de consola de Configuration Manager.

En función de la versión de Configuration Manager que esté ejecutando, hay disponibles diferentes opciones de importación. Inicialmente, solo se podían importar extensiones firmadas a través del servicio de administración. Más adelante se agregó compatibilidad con la importación de extensiones sin firmar. A continuación, se introdujo en la versión 2111 un asistente que podía importar extensiones firmadas y sin signo sin tener que ejecutar un script.

Versión de Configuration Manager 2103 2107 2111 o posterior
Importación de una extensión firmada Sí Sí Sí
Importación de una extensión sin signo No Sí, cuando se permite unsigned Sí, cuando se permite unsigned
Importación desde el servicio de administración con un script de PowerShell Sí, solo extensiones firmadas Sí Sí
Importar desde el Asistente para importar la extensión de consola No No Sí

Cómo importar extensiones de consola

Para importar extensiones de consola, seguirá cuatro pasos básicos. La forma exacta de importar se determinará mediante la versión de Configuration Manager que esté usando y si la extensión está firmada o no. Para importar e instalar una extensión de consola aprobada por la jerarquía, los pasos de alto nivel son:

  1. Determine si necesita permitir extensiones de consola aprobadas por la jerarquía sin signo (versión 2107 y posteriores).
  2. Importe la extensión de consola mediante uno de los métodos siguientes:
  3. Pruebe la extensión en una consola local.
  4. Habilite las notificaciones para permitir que los usuarios de la consola instalen la extensión de consola.

Permitir extensiones de consola sin signo para la jerarquía

(Se aplica a Configuration Manager versión 2107 o posterior)

A partir de Configuration Manager versión 2107, puede optar por permitir extensiones de consola aprobadas por jerarquía sin signo. Se recomienda usar siempre extensiones firmadas para minimizar los riesgos de seguridad y confirmar la autenticidad de una extensión de consola. Sin embargo, en algunos casos es posible que tenga que permitir extensiones de consola sin firmar debido a una extensión desarrollada internamente sin signo o para probar su propia extensión personalizada en un laboratorio. Para permitir la importación e instalación de extensiones de consola aprobadas por jerarquía sin signo, habilitará una configuración de jerarquía.

  1. En la consola de Configuration Manager, vaya al área de trabajo Administración, expanda Configuración del sitio y seleccione Sitios.
  2. Seleccione Configuración de jerarquía en la cinta de opciones.
  3. En la pestaña General , habilite la opción Extensiones de consola aprobadas por la jerarquía.
  4. Seleccione Aceptar cuando haya terminado para cerrar las propiedades de configuración de jerarquía.

Nota:

Actualmente, cuando una extensión sin signo no está habilitada para la notificación del usuario, en el nodo Extensiones de consola , la columna Requerido permanece en blanco en lugar de rellenar un valor de No.

Importación de una extensión de consola firmada con un script

(Se aplica a Configuration Manager versión 2103 o posterior)

Cuando tiene una extensión empaquetada en un archivo firmado.cab, puede importarla en Configuration Manager. Para ello, se publica a través del servicio de administración mediante un script de PowerShell. Una vez insertada la extensión en el sitio, puede aprobarla e instalarla localmente desde el nodo Extensiones de consola . Para importar, ejecute el siguiente script de PowerShell después de editar y $adminServiceProvider$cabFilePath:

  • $adminServiceProvider - El servidor SMSProvider de nivel superior donde está instalado el servicio de administración
  • $cabFilePath - Ruta de acceso al archivo firmado .cab de la extensión
$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."}

Importación de una extensión de consola sin signo con un script

(Se aplica a Configuration Manager versión 2107 o posterior)

A partir de Configuration Manager versión 2107, puede optar por permitir extensiones de consola aprobadas por jerarquía sin signo. Se recomienda usar siempre extensiones firmadas para minimizar los riesgos de seguridad y confirmar la autenticidad de una extensión de consola. Sin embargo, en algunos casos es posible que tenga que permitir extensiones de consola sin firmar debido a una extensión desarrollada internamente sin signo o para probar su propia extensión personalizada en un laboratorio.

Cuando tenga el .cab archivo de una extensión, puede probarlo en un entorno de laboratorio Configuration Manager. Para ello, se publica a través del servicio de administración. Una vez insertada la extensión en el sitio, puede aprobarla e instalarla localmente desde el nodo Extensiones de consola . Para importar, ejecute el siguiente script de PowerShell después de editar y $adminServiceProvider$cabFilePath:

  • $adminServiceProvider - El servidor SMSProvider de nivel superior donde está instalado el servicio de administración
  • $cabFilePath - Ruta de acceso al archivo de la .cab extensión
$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:

Actualmente, cuando una extensión sin signo no está habilitada para la notificación del usuario, en el nodo Extensiones de consola , la columna Requerido permanece en blanco en lugar de rellenar un valor de No.

Asistente para importar extensiones de consola

(Se aplica a Configuration Manager versión 2111 o posterior)

A partir de la versión 2111, puede usar el Asistente para importar extensiones de consola para importar extensiones de consola administradas para la jerarquía. Ya no es necesario usar un script de PowerShell para importar una extensión de consola firmada o sin firmar. Para importar una extensión de consola mediante el asistente:

  1. En el área de trabajo Administración, expanda Novedades y Mantenimiento y, a continuación, seleccione el nodo Extensiones de consola.
  2. Seleccione Importar extensión de consola en la cinta de opciones o en el menú contextual.
  3. Cuando se inicie el asistente, seleccione Examinar y vaya al archivo cab de la extensión.
  4. Si es necesario, seleccione la opción Permitir que la extensión se desasigne.
  5. Seleccione Siguiente para revisar el resumen de importación y, a continuación, complete el asistente para importar la extensión.

Nota:

Para importar extensiones sin firmar, la opción Desasignar las extensiones de consola aprobadas por la jerarquía debe estar habilitada en La configuración de jerarquía. Para obtener más información, consulte Permitir extensiones de consola aprobadas por jerarquía sin signo.

Instalación y prueba de una extensión en una consola local

  1. Cambie el ámbito de seguridad de la extensión. Se recomienda cambiar el ámbito de seguridad para las pruebas iniciales de una extensión.

    1. Vaya al nodo Extensiones de consola enIntroducción> a la administración>Novedades y Mantenimiento.
    2. Seleccione la extensión y, a continuación, seleccione Establecer ámbitos de seguridad en la cinta de opciones.
    3. Quite el ámbito de seguridad predeterminado y agregue un ámbito que solo contenga uno o dos administradores para las pruebas iniciales.
    4. Elija Aceptar para guardar el ámbito de seguridad de la extensión.

  2. Para aprobar la extensión, seleccione Aprobar instalación en la cinta de opciones o en el menú contextual.

    • Si la extensión no está aprobada, no podrá instalarla ni habilitar las notificaciones en la consola para ella.
    • Si reinicia la consola en este momento, no se producirá una notificación sobre la extensión disponible, ya que aún no ha habilitado la opción.

  3. Para instalar la extensión en la consola local, elija Instalar.

  4. Una vez instalada la extensión, compruebe que se muestra y puede usarla desde la consola local.

Habilitación de notificaciones de usuario para la instalación de extensiones

  1. Si es necesario, modifique los ámbitos de seguridad de la extensión para permitir el acceso de más administradores. Estos administradores tendrán como destino la notificación en la consola para instalar la extensión.
  2. Seleccione Habilitar notificaciones.
  3. Inicie una consola de Configuration Manager que no tenga instalada la extensión. Lo ideal es usar una cuenta de prueba a la que dio acceso al modificar el ámbito de seguridad.
  4. Compruebe que se produce la notificación de la extensión y que puede instalar la extensión.

Pasos siguientes