Importieren von Katalogelementen in SPF

Wichtig

Diese Version von Service Provider Foundation (SPF) hat das Ende des Supports erreicht. Es wird empfohlen, ein Upgrade auf SPF 2019 durchzuführen.

Katalogelemente sind VM-Rollen, die als Standardartefakte und wiederverwendbare Artefakte dienen. Diese Elemente können von Hostingdienstanbietern verwendet werden, um Angebote für ihre Mandanten bereitzustellen. In Windows Azure Pack können Sie einem Mandantenabonnementplan ein Katalogelement hinzufügen. Rollen virtueller Maschinen stellen eine skalierbare Ebene virtueller Maschinen dar, die von Mandanten mit einem einzigen Prozess bereitgestellt werden kann. Bei durch Rollen virtueller Maschinen generierten Arbeitsauslastungen kann es sich beispielsweise um eine einzelne virtuelle Maschine, einen Active Directory Domain Controller, ein SQL Server-Cluster oder eine Webfarm von Internetinformationsdienste (IIS) handeln. Erfahren Sie mehr über Katalogressourcen.

In System Center – Service Provider Foundation (SPF) können Sie Katalogelemente aus heruntergeladenen Ressourcenpaketen in System Center - Virtual Machine Manager (VMM) importieren. Die Katalogelemente werden in der SPFDB-Datenbank nachverfolgt. Katalogelemente sind dann sofort für die Anzeige im Verwaltungsportal durch Windows Azure Pack-Administratoren verfügbar.

SPF stellt die folgenden Cmdlets für den Katalog bereit:

  • Get-SCSPFVMRoleGalleryItem

  • Get-SCSPFVMRoleGalleryItemIcon

  • Get-SCSPFVMRoleGalleryItemPackage

  • Import-SCSpfVMRoleGalleryItem

  • Remove-SCSPFVMRoleGalleryItem

  • Set-SCSPFVMRoleGalleryItem

Sie können den SPF-Administratorwebdienst oder Cmdlets verwenden, um ein Katalogpaket, ein Element oder das Symbol für ein Element abzurufen. Portalentwickler können Benutzeroberflächenelemente und -funktionen erstellen, um Mandanten eine überzeugende Erfahrung bei der Auswahl von Katalogelementen zu bieten.

Das folgende Beispiel zeigt, wie Sie powerShell verwenden, um ein Katalogelement aus einem Paket zu importieren und dessen Inhalt zu verwenden und es dann zu entfernen.

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"