Importación de elementos de la galería en SPF

  • Artículo

Importante

Esta versión de Service Provider Foundation (SPF) ha alcanzado el final del soporte técnico; se recomienda actualizar a SPF 2022.

Los elementos de la galería son roles de máquina virtual que sirven como artefactos estándar y reutilizables. Estos elementos se pueden usar mediante el hospedaje de proveedores de servicios para proporcionar ofertas a sus inquilinos. En Microsoft Azure Pack, puede agregar un elemento de galería a un plan de suscripción de inquilino. Los roles de máquina virtual representan un nivel escalable de máquinas virtuales que un inquilino puede aprovisionar mediante un único proceso. Algunos ejemplos de cargas de trabajo que los roles de máquinas virtuales pueden crear son la máquina virtual única, un controlador de dominio de Active Directory, un clúster de SQL Server o una granja de servidores de Internet Information Services (IIS). Obtenga más información sobre los recursos de la galería.

En System Center - Service Provider Foundation (SPF), puede importar elementos de la galería en System Center - Virtual Machine Manager (VMM) desde paquetes de recursos descargados. Se realiza un seguimiento de los elementos de la galería en la base de datos SPFDB. Los elementos de la galería estarán disponibles inmediatamente para su visualización en el portal de administración por parte de los administradores de Microsoft Azure Pack.

SPF proporciona los siguientes cmdlets para la galería:

  • Get-SCSPFVMRoleGalleryItem

  • Get-SCSPFVMRoleGalleryItemIcon

  • Get-SCSPFVMRoleGalleryItemPackage

  • Import-SCSpfVMRoleGalleryItem

  • Remove-SCSPFVMRoleGalleryItem

  • Set-SCSPFVMRoleGalleryItem

Puede usar el servicio web o cmdlets de SPF Administración para obtener un paquete de galería, un elemento o el icono de un elemento. Los desarrolladores de portales pueden crear elementos de interfaz de usuario y funcionalidad para ofrecer a los inquilinos una experiencia atractiva en la selección de elementos de la galería.

En el ejemplo siguiente se muestra cómo usar PowerShell para importar un elemento de la galería desde un paquete y usar su contenido y, a continuación, quitarlo.

PS C:\> # The first command gets the path to the resource package and stores it in the $Path variable.   
PS C:\> # The second command gets a System.IO.FileStream object of the package.   
PS C:\> # The third command imports the package.  
PS C:\> $Path = "c:\packages\create.resdefpkg"  
PS C:\> $FStream = New-Object IO.FileStream $Path, Open  
PS C:\> Import-SCSPFVMRoleGalleryItem -Package $FStream  
PS C:\>  
PS C:\> # Get an item from the gallery by specifying its name and store it in the $galItem variable.  
PS C:\> $galItem = Get-ScSpfVmRoleGalleryItem -Name 570569955cbfb62b374358b34467020750f65c  
PS C:\>   
PS C:\> # Get the icon object by specifying the required parameters with the variable.   
PS C:\> # The IconFileName parameter is explicitly specified in case the variable has a null value for the icon file name.  
PS C:\> $galItemIcon = Get-SCSPFVMRoleGalleryItemIcon -Name $galItem.Name -Publisher $galItem.Publisher -Version $galItem.Version -IconFilename "contoso.ico"  
PS C:\>  
PS C:\> # Get the package of the gallery and stores it in the $galPkg variable. This cmdlets returns an System.IO.MemoryStream object.  
PS C:\> $galPkg = Get-SCSPFVMRoleGalleryItemPackage -Name 570569955cbfb62b374358b34467020750f65c -Publisher Microsoft -Version 1.0.0.0  
PS C:\>   
PS C:\> # One use of the memory stream of the package is to save it to a file on your computer.  
PS C:\> $fs = New-Object IO.Filestream "c:\@tmp\gal.bin", Create  
PS C:\> $binwriter = New-Object IO.BinaryWriter $fs  
PS C:\> $binwriter.Write($galPkg.ContentStream.ToArray())  
PS C:\> $fs.Close()  
PS C:\> $binwriter.Close()  
PS C:\>  
PS C:\> # Import the package that was just saved, using the PackageFilePath parameter.  
PS C:\> Import-ScSpfVmRoleGalleryItem -PackageFilePath "C:\@tmp\gal.bin"