Importar elementos de la Galería de SPFImport gallery items in SPF

Manzanas para: System Center 2016Apples To: System Center 2016

Elementos de la Galería son roles de máquina virtual que actúan como artefactos estándares y reutilizables.Gallery items are virtual machine roles that serve as standard and reusable artifacts. Estos elementos se pueden usar en proveedores de servicios hospedados para proporcionar ofertas a sus inquilinos.These items can be used by hosting service providers, to provide offerings to their tenants. En Windows Azure Pack, puede agregar un elemento de la galería a un plan de suscripción de inquilino.In Windows Azure Pack, you can add a gallery item to a tenant subscription plan. Los roles de máquina virtual representan un nivel escalable de máquinas virtuales que un inquilino puede aprovisionar mediante un único proceso.Virtual machine roles represent a scalable tier of virtual machines that can be provisioned by a tenant using a single process. Ejemplos de cargas de trabajo que se pueden crear roles de máquina virtual pudieron incluir una sola máquina virtual, un controlador de dominio de Active Directory, un clúster de SQL Server o Internet Information Services (IIS) granja de servidores web.Examples of workloads that can be created by virtual machine roles could include a single virtual machine, an Active Directory Domain Controller, a SQL Server cluster, or Internet Information Services (IIS) web farm. Obtener más información acerca de los recursos de galería.Learn more about gallery resources.

En System Center 2026 - Service Provider Foundation (SPF), puede importar elementos de la galería en System Center 2016 - Virtual Machine Manager (VMM) de paquetes de recursos descargados.In System Center 2026- Service Provider Foundation (SPF), you can import gallery items into System Center 2016 - Virtual Machine Manager (VMM) from downloaded resource packages. Se realiza el seguimiento de elementos de la galería en la base de datos SPFDB.The gallery items are tracked in the SPFDB database. Elementos de la galería, a continuación, estarán disponibles inmediatamente para su visualización en el portal de administración, los administradores de Windows Azure Pack.Gallery items will then be immediately available for viewing in the management portal, by Windows Azure Pack administrators.

SPF proporciona los siguientes cmdlets para la Galería:SPF provides the following cmdlets for the gallery:

  • Obtener-SCSPFVMRoleGalleryItemGet-SCSPFVMRoleGalleryItem

  • Obtener-SCSPFVMRoleGalleryItemIconGet-SCSPFVMRoleGalleryItemIcon

  • Obtener-SCSPFVMRoleGalleryItemPackageGet-SCSPFVMRoleGalleryItemPackage

  • Importar-SCSpfVMRoleGalleryItemImport-SCSpfVMRoleGalleryItem

  • Quitar-SCSPFVMRoleGalleryItemRemove-SCSPFVMRoleGalleryItem

  • Establecer-SCSPFVMRoleGalleryItemSet-SCSPFVMRoleGalleryItem

Puede usar el servicio web de administración de SPF o los cmdlets para obtener un paquete de galería, elemento o el icono de un elemento.You can use the SPF Admin web service or cmdlets to get a gallery package, item, or the icon for an item. Los desarrolladores del portal pueden crear elementos de interfaz de usuario y una función para ofrecer a los inquilinos una experiencia convincente en la selección de elementos de la galería.Portal developers can create UI elements and functionality, to offer tenants a compelling experience in selecting gallery items.

En el ejemplo siguiente se muestra cómo usar PowerShell para importar un elemento de la Galería de un paquete y usar su contenido y, a continuación, quítela.The following example shows how to use PowerShell to import a gallery item from a package and use its contents, and then remove it.

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"