Erweiterungen werden veröffentlicht.Publishing Extensions

Gilt für: Windows Admin Center, Windows Admin Center-VorschauApplies To: Windows Admin Center, Windows Admin Center Preview

Nachdem Sie Ihre Erweiterung entwickelt haben, möchten Sie Sie veröffentlichen und anderen Benutzern zur Verfügung stellen, um Sie zu testen oder zu verwenden.Once you've developed your extension, you will want to publish it and make it available to others to test or use. Abhängig von Ihrer Zielgruppe und dem Zweck der Veröffentlichung stehen Ihnen einige Optionen zur Verfügung, die wir unten zusammen mit den Schritten und Anforderungen für die Veröffentlichung vorstellen werden.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 konfigurierbare Paketquellen, die von Windows Admin Center unterstützt werden:There are three primary options for configurable package sources that Windows Admin Center supports:

  • Der öffentliche Windows Admin Center-nuget-Feed von MicrosoftMicrosoft's public Windows Admin Center NuGet feed
  • Ihren eigenen privaten nuget-FeedYour own private NuGet feed
  • Lokale Datei oder Netzwerkdatei FreigabeLocal or network file share

Veröffentlichen im Windows Admin Center-Erweiterungs FeedPublishing to the Windows Admin Center extension feed

Standardmäßig ist das Windows Admin Center mit einem nuget-Feed verbunden, der vom Windows Admin Center-Produktteam bei Microsoft verwaltet wird.By default, Windows Admin Center is connected to a NuGet feed maintained by the Windows Admin Center product team at Microsoft. Frühe Vorschau Versionen von neuen Erweiterungen, die von Microsoft entwickelt wurden, können in diesem Feed veröffentlicht und für Benutzer von Windows Admin Center 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 die Erstellung und Freigabe von Erweiterungen öffentlich planen, übermitteln möglicherweise auch eine Anforderung zur Veröffentlichung in diesem Feed.External developers planning to build and release extensions publicly may also submit a request to publish to this feed. Vor der Veröffentlichung in diesem Feed müssen externe Entwickler der erweiterungsherausgeber Vereinbarung des Windows Admin Centers und der Erweiterungs Teilnahme Richtliniezustimmen.Prior to publishing to this feed, external developers will have to agree to Windows Admin Center's Extension Publisher Agreement and Extension Participation Policy.

Veröffentlichen in einem anderen nuget-FeedPublishing to a different NuGet feed

Sie können auch einen eigenen nuget-Feed erstellen, um Ihre Erweiterungen unter Verwendung einer der vielen unterschiedlichen Optionen zum Einrichten einer privaten Quelle oder mithilfe eines nuget-Hostingdienstszu veröffentlichen.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 die nuget v2-API unterstützen.The NuGet feed must support the NuGet v2 API. Da Windows Admin Center derzeit keine Feed-Authentifizierung unterstützt, muss der Feed so konfiguriert werden, dass jeder beliebige den Lesezugriff zulässt.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

Sie können eine SMB-Dateifreigabe als Erweiterungs Feed verwenden, um den Zugriff ihrer Erweiterung auf Ihre Organisation oder auf eine begrenzte Gruppe von Personen einzuschränken.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 Berechtigungen für die Dateifreigabe und den Ordner angewendet, um den Zugriff auf den Feed zuzulassen.In this case, the file share and folder permissions will be applied for allowing access to the feed.

Vorbereiten der Extension für ReleasePreparing your extension for release

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

Als Vorschauversion veröffentlichenConsider releasing as a Preview release

Wenn Sie eine Vorschauversion ihrer Erweiterung zu Evaluierungs Zwecken veröffentlichen, empfehlen wir Folgendes:If you are releasing a preview version of your extension for evaluation purposes, we recommend that you:

  • Fügen Sie am Ende des Erweiterungs Titels in der nuspec-Datei "(Vorschau)" an.Append "(Preview)" to the end of your extension's title in the .nuspec file
  • Erläutern der Einschränkungen in der Beschreibung ihrer Erweiterung in der nuspec-DateiExplain the limitations in your extension's description in the .nuspec file

Erstellen eines ErweiterungspaketsCreating an extension package

Windows Admin Center verwendet nuget-Pakete und Feeds zum Verteilen und Herunterladen von Erweiterungen.Windows Admin Center utilizes NuGet packages and feeds for distributing and downloading extensions. Damit Ihr Paket ausgeliefert werden kann, müssen Sie ein nuget-Paket mit den Plug-ins und Erweiterungen 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ächen Erweiterung als auch ein Gateway-Plug-in enthalten. im folgenden Abschnitt werden Sie durch den Prozess geführt.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 die Erweiterung.1. Build your extension

Sobald Sie bereit sind, mit dem Packen Ihrer Erweiterung zu beginnen, erstellen Sie ein neues Verzeichnis auf Ihrem Dateisystem, öffnen Sie eine Konsole, und führen Sie eine CD ein.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. Dabei handelt es sich um das Stammverzeichnis, in dem alle nuspec-und Inhaltsverzeichnisse enthalten sein werden, aus denen das 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. Dieser Ordner wird für die Dauer dieses Dokuments als "nuget-Paket" referenziert.We will reference this folder as "NuGet Package" for the duration of this document.

Erweiterungen der BenutzeroberflächeUI Extensions

Führen Sie "Gulp Build" in Ihrem Tool aus, und stellen Sie sicher, dass der Build erfolgreich ist.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. Bei diesem Prozess werden alle Komponenten in einem Ordner namens "Bundle" zusammengefasst, der sich im Stammverzeichnis Ihrer Erweiterung befindet (auf derselben Ebene des src-Verzeichnisses).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 den gesamten Inhalt in den Ordner "nuget-Paket".Copy this directory and all it's contents into the "NuGet Package" folder.

Plug-insGateway Plugins

Verwenden Sie Ihre buildinfrastruktur (Dies könnte so einfach sein wie das Öffnen von Visual Studio und das Klicken auf die Schaltfläche "Build"), kompilieren und erstellen Sie dasUsing your Build infrastructure (this could be as simple as opening Visual Studio and clicking the Build button), compile and build your plugin. Öffnen Sie das Buildausgabeverzeichnis, und kopieren Sie die dll (s), die das Plug-in darstellen, und fügen Sie Sie in einem neuen Ordner im Verzeichnis "nuget-Paket" mit dem Namen "Package" ein.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 die featureinterface-dll nicht kopieren, sondern nur die dll (s), die Ihren Code darstellen.You do not need to copy the FeatureInterface dll, just the Dll(s) that represent your code.

2. Erstellen Sie die nuspec-Datei.2. Create the .nuspec file

Um das nuget-Paket zu erstellen, müssen Sie zunächst eine nuspec-Datei erstellen.To create the NuGet package, you need to first create a .nuspec file. Bei einer nuspec-Datei handelt es sich um ein XML-Manifest, das nuget-Paket Metadaten 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 Benutzer verwendet.This manifest is used both to build the package and to provide information to consumers. Legen Sie diese Datei im Stammverzeichnis des Ordners "nuget-Paket" ab.Place this file at the root of the "NuGet Package" folder.

Im folgenden finden Sie ein Beispiel für eine nuspec-Datei und die Liste der erforderlichen oder empfohlenen Eigenschaften.Here's an example .nuspec file and the list of required or recommended properties. Das vollständige Schema finden Sie in der . nuspec-Referenz.For the full schema, see the .nuspec reference. Speichern Sie die nuspec-Datei im Stamm Ordner Ihres Projekts mit einem Dateinamen Ihrer Wahl.Save the .nuspec file to your project's root folder with a file name of your choice.

Wichtig

Der <id> Wert in der nuspec-Datei muss mit dem "name" Wert in der Projektdatei identisch sein manifest.json , oder Ihre veröffentlichte Erweiterung wird nicht erfolgreich in das 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="https://schemas.microsoft.com/packaging/2011/08/nuspec.xsd">
  <metadata>
    <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", bei dem es sich um den nuget-Pakettyp handelt, der für Erweiterungen des Windows Admin CentersUse "WindowsAdminCenterExtension" which is the NuGet package type defined for Windows Admin Center extensions.
idid ErforderlichRequired Eindeutiger Paket Bezeichner innerhalb des Feeds.Unique Package identifier within the feed. Dieser Wert muss mit dem Wert "Name" in der manifest.jsDatei Ihres Projekts identisch sein.This value needs to match the "name" value in your project's manifest.json file. Informationen finden Sie unter Choosing a unique package identifier (Auswählen eines eindeutigen Paketbezeichners).See Choosing a unique package identifier for guidance.
titletitle Zum Veröffentlichen im Windows Admin Center-Feed erforderlichRequired for publishing to the Windows Admin Center feed Anzeige Name für das Paket, das im Windows Admin Center Extension Manager angezeigt wird.Friendly name for the package that is displayed in Windows Admin Center Extension Manager.
versionversion ErforderlichRequired Erweiterungs Version.Extension version. Die Verwendung der semantischen Versionsverwaltung (semver-Konvention) wird empfohlen, ist jedoch nicht erforderlich.Using Semantic Versioning (SemVer convention) is recommended but not required.
authorsauthors ErforderlichRequired Wenn Sie im Auftrag Ihres Unternehmens 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 Funktionalität der Erweiterung an.Provide a description of the extension's functionality.
iconUrliconUrl Empfohlen beim Veröffentlichen im Windows Admin Center-FeedRecommended when publishing to the Windows Admin Center feed Die URL für das Symbol, das im Erweiterungs-Manager angezeigt werden soll.URL for icon to display in the Extension Manager.
projectUrlprojectUrl Zum Veröffentlichen im Windows Admin Center-Feed erforderlichRequired for publishing to the Windows Admin Center feed URL zur Website ihrer Erweiterung.URL to your extension's website. Wenn Sie nicht über eine separate Website verfügen, verwenden Sie die URL für die Paket Webseite im nuget-Feed.If you do not have a separate website, use the URL for the package webpage on the NuGet feed.
licenseUrllicenseUrl Zum Veröffentlichen im Windows Admin Center-Feed erforderlichRequired for publishing to the Windows Admin Center feed URL zum Endbenutzer-Lizenzvertrag ihrer Erweiterung.URL to your extension's end user license agreement.
Dateienfiles ErforderlichRequired Mit diesen beiden Einstellungen wird die Ordnerstruktur eingerichtet, die das 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 das nuget-Paket für Erweiterungen.3. Build the extension NuGet package

Mithilfe der zuvor erstellten nuspec-Datei erstellen Sie jetzt die nupkg-Datei "nuget Package", die Sie hochladen und in den nuget-Feed veröffentlichen können.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 von der Website für die nuget-Client Toolsherunter.Download the nuget.exe CLI tool from the NuGet client tools website.
  2. Führen Sie "nuget.exe Pack [. nuspec File Name]" aus, um die nupkg-Datei zu erstellen.Run "nuget.exe pack [.nuspec file name]" to create the .nupkg file.

4. Signieren eines nuget-Pakets für die Erweiterung4. Signing your extension NuGet package

Alle dll-Dateien, die in ihrer Erweiterung enthalten sind, müssen mit einem Zertifikat von einer vertrauenswürdigen Zertifizierungsstelle (Certificate Authority, 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 wird die Ausführung von nicht signierten dll-Dateien blockiert, wenn das 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.

Außerdem wird dringend empfohlen, dass Sie das nuget-Paket für die Erweiterung signieren, um die Integrität des Pakets sicherzustellen. Dies ist jedoch kein erforderlicher Schritt.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 das nuget-Paket der Erweiterung.5. Test your extension NuGet package

Das Erweiterungspaket ist jetzt zum Testen bereit!Your extension package is now ready for testing! Laden Sie die nupkg-Datei in einen nuget-Feed hoch, oder kopieren Sie Sie in eine Dateifreigabe.Upload the .nupkg file to a NuGet feed or copy it to a file share. Um Pakete aus einem anderen Feed oder einer anderen Dateifreigabe anzuzeigen und herunterzuladen, müssen Sie die Feed-Konfiguration so ändern , dass Sie auf den nuget-Feed oder die Dateifreigabe verweist.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. Stellen Sie beim Testen sicher, dass die Eigenschaften im Erweiterungs-Manager richtig angezeigt werden und Sie die Erweiterung erfolgreich installieren und deinstallieren können.When testing, make sure the properties are displayed correctly in Extension Manager and you can successfully install and uninstall your extension.

Veröffentlichen der Erweiterung im Windows Admin Center-FeedPublishing your extension to the Windows Admin Center feed

Wenn Sie im Windows Admin Center-Feed veröffentlichen, können Sie die Erweiterung für jeden Windows Admin Center-Benutzer verfügbar machen.By publishing to the Windows Admin Center feed, you can make your extension available to any Windows Admin Center user. Da sich das SDK für Windows Admin Center noch in der Vorschau Phase befindet, möchten wir Ihnen eng mit Ihnen zusammenarbeiten, um Entwicklungsprobleme zu beheben, und sicherstellen, dass Sie für Ihre Benutzer ein qualitativ hochwertiges Produkt und eine Qualität bereitstellen können.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 Übermitteln einer Anforderung zur Erweiterungs Überprüfung an Microsoft müssen Sie eine e-Mail senden, wacextensionrequest@microsoft.com die die Absicht zum Veröffentlichen einer Erweiterung im öffentlichen Feed ausdrückt.Prior to submitting an extension review request to Microsoft, you must send an email to wacextensionrequest@microsoft.com expressing the intent to publish an extension to the public feed. Wir geben Ihnen Kopien der Erweiterungs Herausgeber Vereinbarung und der Erweiterungs Teilnahme-Richtlinie, um Sie zu überprüfen und zu bestätigen.We will provide you will copies of the Extension Publisher Agreement and the Extension Participation Policy to review and acknowledge in writing.

Bevor Sie die erste Version ihrer Erweiterung freigeben, empfiehlt es sich, eine Anforderung zur Erweiterungs Überprüfung mindestens 2-3 Wochen vor der Freigabe an Microsoft zu senden, um sicherzustellen, dass ausreichend Zeit für die Überprüfung vorhanden ist, und dass Sie ggf. Änderungen an ihrer Erweiterung vornehmen können.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 Ihre Extension bereit für die Veröffentlichung ist, müssen Sie Sie zur Überprüfung an uns senden. Wenn Sie genehmigt ist, veröffentlichen wir Sie für Sie im Feed.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. Durch Senden von Microsoft Ihr Erweiterungspaket Stimmen Sie zu, dass Sie mit den Bedingungen des extensionherausgeber Vertrags und der Erweiterungs Teilnahme Richtlinie gebunden werden.By sending Microsoft your extension package, you agree to be bound by the terms of the Extension Publisher Agreement and the Extension Participation Policy.

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

Übermitteln einer Anforderung zur Erweiterungs Überprüfung an MicrosoftSubmit an extension review request to Microsoft

Geben Sie die folgenden Informationen ein, und senden Sie als e-Mail an, um eine Anforderung zur Erweiterungs Überprüfung zu übermitteln 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 auf 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 Ihr Erweiterungspaket zum Überprüfen und veröffentlichen.Submit your extension package for review and publishing

Stellen Sie sicher, dass Sie die oben aufgeführten Anweisungen zum Erstellen eines Erweiterungspakets befolgen und die nuspec-Datei ordnungsgemäß definiert ist und Dateien signiert sind.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 über eine Projektwebsite verfügen, die Folgendes umfasst:We also recommend that you have a project website including the following:

  • Ausführliche 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 bereit sind, ihre Erweiterung zu veröffentlichen, senden Sie eine e-Mail an, wacextensionrequest@microsoft.com und wir geben Ihnen Anweisungen, wie Sie uns Ihr Erweiterungspaket senden.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. Sobald wir Ihr Paket erhalten haben, überprüfen wir, ob Sie im Windows Admin Center-Feed veröffentlicht werden.Once we receive your package, we will review and if approved, publish to the Windows Admin Center feed.