Veröffentlichen von ErweiterungenPublishing Extensions

Gilt für: Windows Admin Center, Windows Admin Center PreviewApplies To: Windows Admin Center, Windows Admin Center Preview

Nachdem Sie die Erweiterung entwickelt haben, sollten Sie es veröffentlichen und andere Benutzer testen oder verwenden Sie zur Verfügung zu stellen.Once you've developed your extension, you will want to publish it and make it available to others to test or use. Je nach Ihrer Zielgruppe und der Zweck der Veröffentlichung stehen einige Optionen, die wir unten zusammen mit die Schritte und Anforderungen für die Veröffentlichung einführen, sollten Sie zur Verfügung.Depending on your audience and purpose of publishing, there are a few options which we'll introduce below along with the steps and requirements for publishing.

VeröffentlichungsoptionenPublishing Options

Es gibt drei primäre Optionen für die konfigurierbare Paketquellen, die Windows Admin Center unterstützt:There are three primary options for configurable package sources that Windows Admin Center supports:

  • Microsofts öffentliche Windows Admin Center-NuGet-feedMicrosoft's public Windows Admin Center NuGet feed
  • Eigener privater NuGet-feedYour own private NuGet feed
  • Lokale oder Dateifreigabe im NetzwerkLocal or network file share

Der feed Windows Admin Center-Erweiterung veröffentlichenPublishing to the Windows Admin Center extension feed

Standardmäßig Windows Admin Center verbunden ist, um ein NuGet Feeds, die vom Produktteam bei Microsoft Windows Admin Center verwaltet.By default, Windows Admin Center is connected to a NuGet feed maintained by the Windows Admin Center product team at Microsoft. Frühe Preview-Versionen von neuen Erweiterungen, die von Microsoft entwickelte können für diesen Feed veröffentlichte als auch für Windows Admin Center Benutzer verfügbar sein.Early preview versions of new extensions developed by Microsoft may be published to this feed and available to Windows Admin Center users. Externe Entwickler, die planen, erstellen und öffentlich Freigeben von Erweiterungen können auch eine Anfrage für diesen Feed zu veröffentlichen.External developers planning to build and release extensions publicly may also submit a request to publish to this feed.

Veröffentlichen in einer anderen NuGet-feedPublishing to a different NuGet feed

Sie können auch Erstellen Ihres eigenen NuGet-feed, um Ihre Erweiterungen zu veröffentlichen, auf die Verwendung einer der zahlreichen verschiedene Optionen für das Einrichten einer privaten Quelle oder das Verwenden von NuGet Hostingdienst.You may also create your own NuGet feed to publish your extensions to using one of the many different options for setting up a private source or using a NuGet hosting service. Der NuGet-Feed muss es sich um die NuGet v2-API unterstützen.The NuGet feed must support the NuGet v2 API. Da Windows Admin Center feed Authentifizierung derzeit nicht unterstützt wird, muss der Feed konfiguriert werden, um Lesezugriff auf alle Benutzer zu ermöglichen.Since Windows Admin Center does not currently support feed authentication, the feed needs to be configured to allow read access to anyone.

Veröffentlichen in einer DateifreigabePublishing to a file share

Um Zugriff auf Ihre Erweiterung in Ihrer Organisation oder auf eine eingeschränkte Gruppe von Personen zu beschränken, können Sie SMB-Dateifreigabe als feed-Erweiterung.To restrict access of your extension to your organization or to a limited group of people, you can use an SMB file share as an extension feed. In diesem Fall werden die Freigabe- und Dateiberechtigungen angewendet werden, zum Gewähren des Zugriffs auf den Feed.In this case, the file share and folder permissions will be applied for allowing access to the feed.

Vorbereiten der Erweiterungs für die VeröffentlichungPreparing your extension for release

Stellen Sie sicher, dass Sie lesen und erwägen Sie die folgenden Entwicklungsthemen:Make sure you read and consider the following development topics:

Betrachten Sie als Vorschauversion veröffentlichenConsider releasing as a Preview release

Wenn Sie eine Preview-Version der Erweiterung für Evaluierungszwecke freigeben, sollten Sie:If you are releasing a preview version of your extension for evaluation purposes, we recommend that you:

  • Fügen Sie am Ende des Titels für Ihre Erweiterung in der NuSpec-Datei "(Preview)"Append "(Preview)" to the end of your extension's title in the .nuspec file
  • Erläutert die Einschränkungen in Ihre Erweiterung in der Beschreibung in der NuSpec-DateiExplain the limitations in your extension's description in the .nuspec file

Erstellen ein ErweiterungspaketCreating an extension package

Windows Admin Center verwendet die NuGet-Pakete und -Feeds für die Verteilung und das Herunterladen von Erweiterungen.Windows Admin Center utilizes NuGet packages and feeds for distributing and downloading extensions. Damit für Ihr Paket gesendet werden können müssen Sie ein NuGet-Paket, das mit Ihrer-Plug-Ins und Erweiterungen zu generieren.In order for your package to be shipped, you will need to generate a NuGet package containing your plugins and extensions. Ein einzelnes Paket kann sowohl eine Benutzeroberflächenerweiterung als auch eine Gateway-Plug-in enthalten, und der folgende Abschnitt führt Sie durch den Prozess.A single package can contain both a UI extension as well as a Gateway plugin, and the following section will walk you through the process.

1. Erstellen Sie Ihre Erweiterung1. Build your extension

Sobald Sie zum Starten die Erweiterung verpacken, erstellen ein neues Verzeichnis im Dateisystem bereit sind, öffnen Sie die CD und eine Konsole hinein.As soon as you are ready to start packaging your extension, create a new directory on your file system, open a console, and CD into it. Dies wird im Stammverzeichnis sein, das wir verwenden alle Verzeichnisse für die NuSpec-Datei und den Inhalt enthalten, aus denen unser Paket besteht.This will be the root directory that we will use to contain all the nuspec and content directories that will make up our package. Wir werden diesen Ordner als "NuGet-Paket" für die Dauer dieses Dokuments verweisen.We will reference this folder as "NuGet Package" for the duration of this document.

UI-ErweiterungenUI Extensions

Führen Sie die "gulp Build" auf das Tool, und stellen Sie sicher, dass der Build erfolgreich ist, zunächst den Prozess zum Erfassen von alle Inhalte, die für eine Benutzeroberflächenerweiterung erforderlich sind.To begin the process on gathering all the content needed for a UI extension, run "gulp build" on your tool and make sure the build is successful. Dieser Prozesspakete, die alle Komponenten in einen Ordner namens "bündeln" im Stammverzeichnis Ihrer Erweiterung (auf derselben Ebene der das SCR-Verzeichnis) befinden.This process packages all the components together in a folder called "bundle" located in the root directory of your extension (at the same level of the src directory). Kopieren Sie dieses Verzeichnis und alle es handelt sich um Inhalte in den Ordner "NuGet-Paket".Copy this directory and all it's contents into the "NuGet Package" folder.

Gateway-Plug-InsGateway Plugins

Verwenden Ihre Build-Infrastruktur (Dies kann so einfach wie das Visual Studio öffnen, und klicken Sie auf die Schaltfläche "Build" sein), kompilieren Sie und erstellen Sie Ihr Plug-in.Using your Build infrastructure (this could be as simple as opening Visual Studio and clicking the Build button), compile and build your plugin. Öffnen Sie Ihre Buildausgabeverzeichnis, und kopieren Sie die DLLs, die Ihr Plug-in darstellen, und platzieren Sie sie in einen neuen Ordner im Verzeichnis "NuGet-Paket" als "Paket" bezeichnet.Open up your build output directory, and copy the Dll(s) that represent your plugin, and put them in a new folder inside the "NuGet Package" directory called "package". Sie müssen nicht die FeatureInterface-Dll, nur die DLLs zu kopieren, die Ihren Code darstellen.You do not need to copy the FeatureInterface dll, just the Dll(s) that represent your code.

2. Erstellen der NuSpec-Datei2. Create the .nuspec file

Um das NuGet-Paket zu erstellen, müssen Sie zuerst eine NuSpec-Datei zu erstellen.To create the NuGet package, you need to first create a .nuspec file. Eine NuSpec-Datei ist eine XML-Manifestdatei, die NuGet-Paketmetadaten enthält.A .nuspec file is an XML manifest that contains NuGet package metadata. Diese Manifestdatei wird sowohl für die Erstellung des Pakets als auch zur Bereitstellung von Informationen für die Consumer verwendet.This manifest is used both to build the package and to provide information to consumers. Platzieren Sie diese Datei im Stammverzeichnis des Ordners "NuGet-Paket".Place this file at the root of the "NuGet Package" folder.

Hier ist ein Beispiel für NuSpec-Datei und die Liste der Eigenschaften, die erforderliche oder empfohlene.Here's an example .nuspec file and the list of required or recommended properties. Das vollständige Schema finden Sie unter den NuSpec-Referenz.For the full schema, see the .nuspec reference. Die NuSpec-Datei zum Stammordner des Projekts, mit einem Dateinamen Ihrer Wahl zu speichern.Save the .nuspec file to your project's root folder with a file name of your choice.

Wichtig

Die <id> Wert in der NuSpec-Datei entsprechen muss die "name" Wert Ihres Projekts manifest.json Datei ansonsten wird Ihre veröffentlichte Erweiterung nicht erfolgreich in Windows Admin Center geladen.The <id> value in the .nuspec file needs to match the "name" value in your project's manifest.json file, or else your published extension won't load successfully in Windows Admin Center.

<?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://schemas.microsoft.com/packaging/2011/08/nuspec.xsd">
  <metadata>
    <packageTypes>
      <packageType name="WindowsAdminCenterExtension" />
    </packageTypes>  
    <id>contoso.project.extension</id>
    <version>1.0.0</version>
    <title>Contoso Hello Extension</title>
    <authors>Contoso</authors>
    <owners>Contoso</owners>
    <requireLicenseAcceptance>false</requireLicenseAcceptance>
    <projectUrl>https://msft-sme.myget.org/feed/windows-admin-center-feed/package/nuget/contoso.sme.hello-extension</projectUrl>
    <licenseUrl>http://YourLicenseLink</licenseUrl>
    <iconUrl>http://YourLogoLink</iconUrl>
    <description>Hello World extension by Contoso</description>
    <copyright>(c) Contoso. All rights reserved.</copyright> 
    <tags></tags>
  </metadata>
  <files>
    <file src="bundle\**\*.*" target="ux" />
    <file src="package\**\*.*" target="gateway" />
  </files>
</package>
EigenschaftennameProperty Name Erforderlich / empfohlenRequired / Recommended BeschreibungDescription
packageTypepackageType ErforderlichRequired Verwenden Sie "WindowsAdminCenterExtension" der NuGet-Paket für Windows Admin Center-Erweiterungen definiert ist.Use "WindowsAdminCenterExtension" which is the NuGet package type defined for Windows Admin Center extensions.
idid ErforderlichRequired Eindeutiger Bezeichner "Paket" innerhalb des Feeds.Unique Package identifier within the feed. Dieser Wert muss mit dem Wert "Name" in der manifest.json-Datei des Projekts übereinstimmen.This value needs to match the "name" value in your project's manifest.json file. Informationen finden Sie unter Auswählen eines eindeutigen Paketbezeichners und Festlegen der Versionsnummer.See Choosing a unique package identifier for guidance.
titletitle Erforderlich für die Veröffentlichung in der Windows Admin Center-feedRequired for publishing to the Windows Admin Center feed Der Anzeigename für das Paket, das im Windows Admin Center Erweiterungs-Manager angezeigt wird.Friendly name for the package that is displayed in Windows Admin Center Extension Manager.
versionversion ErforderlichRequired Version der Erweiterung.Extension version. Mithilfe von semantische Versionskontrolle (SemVer-Konvention) wird empfohlen, jedoch nicht erforderlich.Using Semantic Versioning (SemVer convention) is recommended but not required.
authorsauthors ErforderlichRequired Wenn für Ihr Unternehmen zu veröffentlichen, verwenden Sie den Namen Ihres Unternehmens.If publishing on behalf of your company, use your company name.
descriptiondescription ErforderlichRequired Geben Sie eine Beschreibung der Funktionen von der Erweiterung.Provide a description of the extension's functionality.
iconUrliconUrl Empfohlen, bei der Veröffentlichung in der Windows Admin Center-feedRecommended when publishing to the Windows Admin Center feed URL für das Symbol in der Erweiterungs-Manager angezeigt.URL for icon to display in the Extension Manager.
projectUrlprojectUrl Erforderlich für die Veröffentlichung in der Windows Admin Center-feedRequired for publishing to the Windows Admin Center feed Die Erweiterung des Website-URL.URL to your extension's website. Wenn Sie nicht über eine separate Website verfügen, verwenden Sie die URL für die Webseite Paket auf NuGet-feed.If you do not have a separate website, use the URL for the package webpage on the NuGet feed.
licenseUrllicenseUrl Erforderlich für die Veröffentlichung in der Windows Admin Center-feedRequired for publishing to the Windows Admin Center feed URL, die Erweiterung des Endbenutzer-Lizenzvertrag.URL to your extension's end user license agreement.
filesfiles ErforderlichRequired Diese beiden Einstellungen richten Sie die Ordnerstruktur, die Windows Admin Center für UI-Erweiterungen und Gateway-Plug-Ins erwartet.These two settings set up the folder structure that Windows Admin Center expects for UI extensions and Gateway plugins.

3. Erstellen Sie die Erweiterung NuGet-Paket3. Build the extension NuGet package

Verwenden der NuSpec-Datei, die, der Sie soeben erstellt haben, nun erstellen die NUPKG-Datei von NuGet-Paket Sie die NuGet-feed veröffentlichen und hochladen kann.Using the .nuspec file you created above, you will now create the NuGet package .nupkg file which you can upload and publish to the NuGet feed.

  1. Laden Sie das nuget.exe-CLI-Tool aus dem NuGet Client Tools-Website.Download the nuget.exe CLI tool from the NuGet client tools website.
  2. Führen Sie "nuget.exe Pack [.nuspec File Name]", um die NUPKG-Datei zu erstellen.Run "nuget.exe pack [.nuspec file name]" to create the .nupkg file.

4. Signieren Ihre Erweiterung NuGet-Paket4. Signing your extension NuGet package

Alle DLL-Dateien enthalten, die in der Erweiterung müssen mit einem Zertifikat von einer vertrauenswürdigen Zertifizierungsstelle (CA) signiert werden.Any .dll files included in your extension are required to be signed with a certificate from a trusted Certificate Authority (CA). Standardmäßig werden ohne Vorzeichen DLL-Dateien blockiert ausgeführt werden, wenn Windows Admin Center im Produktionsmodus ausgeführt wird.By default, unsigned .dll files will be blocked from being executed when Windows Admin Center is running in Production Mode.

Es wird auch stark empfohlen, dass Sie die Erweiterung NuGet-Paket, um sicherzustellen, dass die Integrität der Paket signieren, aber dies kein erforderlicher Schritt ist.We also highly recommend that you sign the extension NuGet package to ensure the integrity of the package, but this is not a required step.

5. Testen Sie Ihrer Erweiterung NuGet-Paket5. Test your extension NuGet package

Ihres Erweiterungspakets ist jetzt bereit zum Testen!Your extension package is now ready for testing! Hochladen der NUPKG-Datei in ein NuGet-Feed ein, oder kopieren Sie ihn an eine Dateifreigabe.Upload the .nupkg file to a NuGet feed or copy it to a file share. Zum Anzeigen und Herunterladen von Paketen von einem anderen Feed oder die Dateifreigabe, müssen Sie ändern Sie die Konfiguration der feed zeigen Sie auf Ihrem NuGet-Feed oder die Dateifreigabe.To view and download packages from a different feed or file share, you'll need to change your feed configuration to point to your NuGet feed or file share. Beim Testen, stellen Sie sicher, dass die Eigenschaften werden ordnungsgemäß im Erweiterungs-Manager angezeigt, und Sie können erfolgreich installieren und deinstallieren die Erweiterung an.When testing, make sure the properties are displayed correctly in Extension Manager and you can successfully install and uninstall your extension.

Veröffentlichen Ihre Erweiterung in der Windows Admin Center-feedPublishing your extension to the Windows Admin Center feed

Durch die Veröffentlichung der Windows Admin Center-feed, können Sie die Erweiterung für alle Benutzer Windows Admin Center zur Verfügung.By publishing to the Windows Admin Center feed, you can make your extension available to any Windows Admin Center user. Da das Windows Admin Center-SDK noch in der Vorschauphase ist, müssen wir möchten, die eng mit der Sie beheben Sie Probleme bei der Entwicklung, und stellen Sie sicher, dass Sie können zum Übermitteln eines Qualitätsprodukts und Ihren Benutzern auftreten.Since the Windows Admin Center SDK is still in preview, we’d like to work closely with you to help resolve development issues, and, make sure you are able to deliver a quality product and experience to your users.

Vor dem Freigeben der ersten Version der Erweiterung, empfehlen wir, eine Erweiterung Review-Anforderung an Microsoft mindestens 2 und 3 Wochen vor der Freigabe übermitteln, um sicherzustellen, dass wir genügend Zeit, um zu überprüfen und Sie Ihre Erweiterung bei Bedarf ändern.Before releasing the initial version of your extension, we recommend that you submit an extension review request to Microsoft at least 2-3 weeks before release to ensure we have sufficient time to review and for you to make any changes to your extension if necessary. Sobald die Erweiterung veröffentlicht werden kann, müssen Sie es zur Überprüfung an uns senden, und bei einer Genehmigung werden wir sie veröffentlichen, auf den Feed für Sie.Once your extension is ready to be published, you'll need to send it to us for review, and if approved, we'll publish it to the feed for you.

Wenn Sie ein Update für Ihre Erweiterung freigeben möchten, müssen Sie anschließend eine weitere Anforderung zur Überprüfung übermitteln.Afterwards, if you want to release an update to your extension, you will need to submit another request for review. Abhängig von der Umfang der Änderungen, sollte die Verarbeitungszeit für die Update-Überprüfung in der Regel kürzer sein.While depending on the scope of change, the turnaround time for update reviews should generally be shorter.

Eine Erweiterung Review-Anforderung an Microsoft sendenSubmit an extension review request to Microsoft

Um eine Anforderung für domänennamenerweiterung Review zu übermitteln, geben Sie die folgende Informationen ein, und als e-Mail zu senden wacextensionrequest@microsoft.com .To submit an extension review request, enter the following information and send as an email to wacextensionrequest@microsoft.com. Wir werden innerhalb einer Woche an Ihre e-Mail Antworten.We will reply to your email within a week.

Windows Admin Center Extension Review Request
1. Name and email address of extension owner/developer (up to 3 users). If you will be releasing an extension on behalf of your company, provide your company email address.
2. Company name (Only required if you are releasing an extension on behalf of your company):
3. Extension name:
4. Release target date (estimate):
5. For new extension submission - Extension description (early design wire frames, screen mockups or product screenshots are highly recommended):
6. For extension update review – Description of changes (include product screenshots if UI has been significantly changed):

Übermitteln Sie Ihres Erweiterungspakets für die Überprüfung und VeröffentlichungSubmit your extension package for review and publishing

Stellen Sie sicher, folgen Sie den Anweisungen oben für erstellen ein Erweiterungspaket und die NuSpec-Datei ordnungsgemäß definiert ist, und Dateien werden signiert.Make sure you follow the instructions above for creating an extension package and the .nuspec file is defined properly and files are signed. Außerdem wird empfohlen, dass Sie eine Projektwebsite, einschließlich der folgenden haben:We also recommend that you have a project website including the following:

  • Detaillierte Beschreibung Ihrer Erweiterung, einschließlich Screenshots oder VideosDetailed description of your extension including screenshots or video
  • E-Mail-Adresse oder Website-Funktion zum Empfangen von Feedback oder FragenEmail address or website feature to receive feedback or questions

Wenn Sie Ihre Erweiterung veröffentlichen möchten, senden Sie eine e-Mail an wacextensionrequest@microsoft.com und Anweisungen zum Senden Ihres Erweiterungspakets bereitgestellt wird.When you are ready to publish your extension, send an email to wacextensionrequest@microsoft.com and we will provide instructions on how to send us your extension package. Wenn wir das Paket erhalten haben, wir prüfen und bei Genehmigung werden die Windows Admin Center-feed veröffentlichen.Once we receive your package, we will review and if approved, publish to the Windows Admin Center feed.