Importação de Itens de Galeria no Service Provider Foundation

Aplicável a: System Center 2012 R2 Orchestrator

Este tópico pertence ao uso da galeria VM Clouds no Windows Azure Pack para Windows Server. Os itens de galeria são funções de máquinas virtuais que atuam como artefatos padrão e reutilizáveis que os provedores de serviços de hospedagem podem utilizar para fornecer ofertas para seus locatários. No Pacote do Windows Azure, é possível acrescentar um item de galeria a um plano que é assinado pelos locatários. Funções de máquinas virtuais representam uma camada dimensionável de máquinas virtuais que podem ser fornecidas por um locatário que utiliza um único processo. Os exemplos de cargas de trabalho que podem ser criadas por funções de máquinas virtuais podem incluir uma única máquina virtual, um controlador de domínio do Active Directory, um cluster do SQL Server ou uma web farm de Internet Information Services (IIS).

Para obter informações sobre a obtenção de recursos de galeria, consulte Downloading and Installing Windows Azure Pack Gallery Resource (Baixar e instalar o recurso de galeria do Windows Azure Pack). Para obter informações sobre a criação de funções de máquinas virtuais, consulte o System Center 2012 R2 Virtual Machine Role Authoring Guide (Guia de criação de funções de máquina virtuais do System Center 2012 R2).

A Base do provedor de serviços permite que se importe itens de galeria para o Virtual Machine Manager a partir de pacotes de recursos baixados. Além disso, os itens da galeria são controlados no banco de dados SPFDB. Ao se fazer isso, os itens de galeria ficarão imediatamente disponíveis para visualização no portal de gerenciamento para administradores, no Pacote do Windows Azure.

Também é possível utilizar o serviço web de administração da Base do provedor de serviços ou cmdlets para obter um pacote de galeria, item ou o ícone para um item. Isso permite que desenvolvedores de portais criem elementos de UI e funcionalidades que permitem oferecer aos locatários uma experiência cativante na seleção de itens de galeria.

O exemplo a seguir mostra como utilizar o Windows PowerShell para importar um item de galeria de um pacote e utilizar seu conteúdo, e então removê-lo.

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"  
  

A Base do provedor de serviços fornece os seguintes cmdlets para a galeria:

• Get-SCSPFVMRoleGalleryItem

• Get-SCSPFVMRoleGalleryItemIcon

• Get-SCSPFVMRoleGalleryItemPackage

• Import-SCSpfVMRoleGalleryItem

• Remove-SCSPFVMRoleGalleryItem

• Set-SCSPFVMRoleGalleryItem

Portais no Service Provider Foundation
Introdução a funções de máquina virtual: Guia passo a passo
Guia de criação de funções de máquina virtuais do System Center 2012 R2 - pacote de definição de recursos
Usando itens da galeria em nuvens da máquina virtual