Einrichten von Previewfunktionen im Azure-Abonnement

In diesem Artikel wird gezeigt, wie Sie Previewfunktionen in Ihrem Azure-Abonnement verwalten. Mit Previewfunktionen können Sie neue Funktionen nutzen, bevor sie veröffentlicht werden. Einige Previewfunktionen sind für jeden verfügbar, der sich dafür entscheiden möchte. Andere Previewfunktionen erfordern eine Genehmigung durch das Produktteam.

Azure Feature Exposure Control (AFEC) ist über den Namespace Microsoft.Features verfügbar. Previewfunktionen haben folgendes Format für die Ressourcen-ID:

Microsoft.Features/providers/{resourceProviderNamespace}/features/{featureName}

Erforderlicher Zugriff

Zum Auflisten, Registrieren oder Aufheben der Registrierung von Previewfunktionen in Ihrem Azure-Abonnement benötigen Sie Zugriff auf die Microsoft.Features/*-Aktionen. Diese Berechtigung wird über die integrierten Rollen Mitwirkender und Besitzer erteilt. Sie können den erforderlichen Zugriff auch über eine benutzerdefinierte Rolle angeben.

Auflisten von Previewfunktionen

Sie können alle Previewfunktionen und deren Registrierungszustände für ein Azure-Abonnement auflisten.

Portal

Hinweis

Das Portal zeigt nur dann eine Previewfunktion an, wenn sich der Dienst, der die Funktion besitzt, explizit für die Previewfunktionen-Verwaltungserfahrung entschieden hat. Falls das gesuchte Feature nicht in der verfügbaren Liste angezeigt wird, empfehlen wir die Verwendung von Azure CLI und Azure Powershell.

1. Melden Sie sich beim Azure-Portal an.

2. Geben Sie im Suchfeld Abonnements ein, und wählen Sie Abonnements aus.

   

3. Wählen Sie den Link für den Namen Ihres Abonnements aus.

   

4. Wählen Sie im linken Menü unter Einstellungen die Option Previewfunktionen aus.

   

5. Es wird eine Liste der verfügbaren Previewfunktionen mit dem jeweiligen aktuellen Registrierungsstatus angezeigt.

   

6. Unter Previewfunktionen können Sie die Liste nach Name, Zustand (State) und Typ (Type) filtern:

   • Nach Name filtern: Muss Text aus dem Namen einer Previewfunktion enthalten, nicht den Anzeigenamen.
   • Zustand: Wählen Sie das Dropdownmenü und dann einen Zustand aus. Das Portal filtert nicht nach Nicht registriert.
   • Typ: Wählen Sie das Dropdownmenü und dann einen Typ aus.

   

Azure-Befehlszeilenschnittstelle

Um alle Previewfunktionen des Abonnements aufzulisten, verwenden Sie den Befehl az feature list.

Das Standardausgabeformat für Azure CLI ist JSON. Weitere Informationen zu weiteren Ausgabeformaten finden Sie unter Ausgabeformate für Azure CLI-Befehle.

az feature list

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Features/providers/
    Microsoft.Compute/features/InGuestPatchVMPreview",
  "name": "Microsoft.Compute/InGuestPatchVMPreview",
  "properties": {
    "state": "NotRegistered"
  },
  "type": "Microsoft.Features/providers/features"
}

Um die Ausgabe nach einem bestimmten Ressourcenanbieter zu filtern, verwenden Sie den Parameter namespace. In diesem Beispiel gibt der Parameter output ein Tabellenformat an.

az feature list --namespace Microsoft.Compute --output table

Name                                                RegistrationState
-------------------------------------------------   -------------------
Microsoft.Compute/AHUB                              Unregistered
Microsoft.Compute/AllowManagedDisksReplaceOSDisk    Registered
Microsoft.Compute/AllowPreReleaseRegions            Pending
Microsoft.Compute/InGuestPatchVMPreview             NotRegistered

Um die Ausgabe nach einer bestimmten Previewfunktion zu filtern, verwenden Sie den Befehl az feature show.

az feature show --name InGuestPatchVMPreview --namespace Microsoft.Compute --output table

Name                                     RegistrationState
---------------------------------------  -------------------
Microsoft.Compute/InGuestPatchVMPreview  NotRegistered

Azure PowerShell

Um alle Previewfunktionen des Abonnements aufzulisten, verwenden Sie das Cmdlet Get-AzProviderFeature.

Get-AzProviderFeature -ListAvailable

FeatureName      ProviderName     RegistrationState
-----------      ------------     -----------------
betaAccess       Microsoft.AAD    NotRegistered
previewAccess    Microsoft.AAD    Registered
tipAccess        Microsoft.AAD    Pending
testAccess       Microsoft.AAD    Unregistered

Um die Ausgabe nach einem bestimmten Ressourcenanbieter zu filtern, verwenden Sie den Parameter ProviderNamespace. In der Standardausgabe werden nur die registrierten Funktionen angezeigt. Um alle Previewfunktionen für einen Ressourcenanbieter anzuzeigen, verwenden Sie den Parameter ListAvailable zusammen mit dem Parameter ProviderNamespace.

Get-AzProviderFeature -ProviderNamespace "Microsoft.Compute" -ListAvailable

FeatureName                          ProviderName        RegistrationState
-----------                          ------------        -----------------
AHUB                                 Microsoft.Compute   Unregistered
AllowManagedDisksReplaceOSDisk       Microsoft.Compute   Registered
AllowPreReleaseRegions               Microsoft.Compute   Pending
InGuestPatchVMPreview                Microsoft.Compute   NotRegistered

Sie können die Ausgabe nach einer bestimmten Previewfunktion filtern, indem Sie den Parameter FeatureName verwenden.

Get-AzProviderFeature -FeatureName "InGuestPatchVMPreview" -ProviderNamespace "Microsoft.Compute"

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   NotRegistered

Registrieren einer Previewfunktion

Registrieren Sie eine Previewfunktion in Ihrem Azure-Abonnement, um weitere Funktionen für einen Ressourcenanbieter verfügbar zu machen. Einige Previewfunktionen erfordern eine Genehmigung.

Nachdem eine Previewfunktion in Ihrem Abonnement registriert wurde, wird einer von zwei Zustände angezeigt: Registriert oder Ausstehend.

• Für eine Previewfunktion, die keine Genehmigung erfordert, ist der Zustand Registriert.
• Wenn eine Previewfunktion eine Genehmigung erfordert, ist der Registrierungszustand Ausstehend. Sie müssen die Genehmigung des Azure-Diensts anfordern, der das Vorschaufeature anbietet. Normalerweise fordern Sie den Zugriff über ein Supportticket an.
  • Um eine Genehmigung anzufordern, übermitteln Sie eine Azure-Supportanfrage.
  • Nachdem die Registrierung genehmigt wurde, ändert sich der Zustand der Previewfunktion in Registriert.

Einige Dienste erfordern andere Methoden, z. B. E-Mail, um die Genehmigung für eine ausstehende Anforderung zu erhalten. Suchen Sie in den Ankündigungen zum Vorschaufeature nach Informationen zum Anfordern des Zugriffs.

Portal

1. Melden Sie sich beim Azure-Portal an.

2. Geben Sie im Suchfeld Abonnements ein, und wählen Sie Abonnements aus.

3. Wählen Sie den Link für den Namen Ihres Abonnements aus.

4. Wählen Sie im linken Menü unter Einstellungen die Option Previewfunktionen aus.

5. Wählen Sie den Link für die Previewfunktion aus, die Sie registrieren möchten.

6. Wählen Sie Registrieren.

   

7. Klicken Sie auf OK.

Der Bildschirm Previewfunktionen wird aktualisiert, und der Zustand der Previewfunktion wird angezeigt.

Azure-Befehlszeilenschnittstelle

Zum Registrieren einer Previewfunktion verwenden Sie den Befehl az feature register.

az feature register --name InGuestPatchVMPreview --namespace Microsoft.Compute

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Features/providers/
    Microsoft.Compute/features/InGuestPatchVMPreview",
  "name": "Microsoft.Compute/InGuestPatchVMPreview",
  "properties": {
    "state": "Registering"
  },
  "type": "Microsoft.Features/providers/features"
}

Um den Status der Registrierung anzuzeigen, verwenden Sie den Befehl az feature show.

az feature show --name InGuestPatchVMPreview --namespace Microsoft.Compute --output table

Name                                     RegistrationState
---------------------------------------  -------------------
Microsoft.Compute/InGuestPatchVMPreview  Registered

Hinweis

Wenn der Registrierungsbefehl ausgeführt wird, wird eine Meldung angezeigt, dass nach der Registrierung der Funktion az provider register --namespace <provider-name> ausgeführt werden soll, um die Änderungen weiterzugeben.

Azure PowerShell

Um eine Previewfunktion zu registrieren, verwenden Sie das CmdletRegister-AzProviderFeature.

Register-AzProviderFeature -FeatureName "InGuestPatchVMPreview" -ProviderNamespace "Microsoft.Compute"

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   Registering

Um den Status der Registrierung anzuzeigen, verwenden Sie das Cmdlet Get-AzProviderFeature.

Get-AzProviderFeature -FeatureName "InGuestPatchVMPreview" -ProviderNamespace "Microsoft.Compute"

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   Registered

Aufheben der Registrierung einer Previewfunktion

Wenn Sie mit der Verwendung einer Previewfunktion fertig sind, heben Sie deren Registrierung in Ihrem Azure-Abonnement auf. Nach dem Aufheben der Registrierung der Funktion sehen Sie möglicherweise zwei verschiedene Status. Wenn Sie die Registrierung über das Portal aufheben, wird der Status auf Nicht registriert festgelegt. Wenn Sie die Registrierung über die Azure CLI, PowerShell oder REST-API aufheben, wird der Status auf Registrierung aufgehoben festgelegt. Der Status ist anders, da das Portal die Funktionsregistrierung löscht, die Befehle aber die Registrierung der Funktion aufheben. In beiden Fällen ist die Funktion in Ihrem Abonnement nicht mehr verfügbar. In beiden Fällen können Sie die Funktion erneut aktivieren, indem Sie sie erneut registrieren.

Portal

Sie können die Registrierung von Previewfunktionen unter Previewfunktionen aufheben. Der Zustand ändert sich in Nicht registriert.

1. Melden Sie sich beim Azure-Portal an.

2. Geben Sie im Suchfeld Abonnements ein, und wählen Sie Abonnements aus.

3. Wählen Sie den Link für den Namen Ihres Abonnements aus.

4. Wählen Sie im linken Menü unter Einstellungen die Option Previewfunktionen aus.

5. Wählen Sie den Link für die Previewfunktion aus, deren Registrierung Sie aufheben möchten.

6. Wählen Sie Registrierung aufheben aus.

   

7. Klicken Sie auf OK.

Azure-Befehlszeilenschnittstelle

Um die Registrierung einer Previewfunktion aufzuheben, verwenden Sie den Befehl az feature unregister. Der Zustand RegistrationState ändert sich in Nicht registriert.

az feature unregister --name InGuestPatchVMPreview --namespace Microsoft.Compute

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Features/providers/
    Microsoft.Compute/features/InGuestPatchVMPreview",
  "name": "Microsoft.Compute/InGuestPatchVMPreview",
  "properties": {
    "state": "Unregistering"
  },
  "type": "Microsoft.Features/providers/features"
}

Um den Status der Registrierungsaufhebung anzuzeigen, verwenden Sie den Befehl az feature show.

az feature show --name InGuestPatchVMPreview --namespace Microsoft.Compute --output table

Name                                     RegistrationState
---------------------------------------  -------------------
Microsoft.Compute/InGuestPatchVMPreview  Unregistered

Hinweis

Wenn der Befehl zur Aufhebung der Registrierung ausgeführt wird, wird eine Meldung angezeigt, dass nach der Aufhebung der Registrierung der Funktion az provider register --namespace <provider-name> ausgeführt werden soll, um die Änderungen weiterzugeben.

Um Previewfunktionen zu finden, deren Registrierung aufgehoben ist, verwenden Sie den folgenden Befehl. Ersetzen Sie <ResourceProvider.Name> durch einen Anbieternamen wie Microsoft.Compute.

Im folgenden Beispiel wird eine Previewfunktion mit aufgehobener Registrierung für den Ressourcenanbieter Microsoft.Compute angezeigt.

az feature list --namespace <ResourceProvider.Name> --query "[?properties.state=='Unregistered'].{Name:name, RegistrationState:properties.state}" --output table

Name                                     RegistrationState
---------------------------------------  -------------------
Microsoft.Compute/InGuestPatchVMPreview  Unregistered

Azure PowerShell

Um die Registrierung einer Previewfunktion aufzuheben, verwenden Sie das CmdletUnregister-AzProviderFeature. Der Zustand RegistrationState ändert sich in Nicht registriert.

Unregister-AzProviderFeature -FeatureName "InGuestPatchVMPreview" -ProviderNamespace "Microsoft.Compute"

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   Unregistering

Um den Status der Registrierungsaufhebung anzuzeigen, verwenden Sie das Cmdlet Get-AzProviderFeature.

Get-AzProviderFeature -FeatureName "InGuestPatchVMPreview" -ProviderNamespace "Microsoft.Compute"

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   Unregistered

Im folgenden Beispiel wird eine Previewfunktion mit aufgehobener Registrierung für den Ressourcenanbieter Microsoft.Compute angezeigt.

Get-AzProviderFeature  -ProviderNamespace "Microsoft.Compute" -ListAvailable | Where-Object { $_.RegistrationState -eq "Unregistered" }

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   Unregistered

Konfigurieren von Vorschaufeatures mithilfe von Azure Policy

Abonnements können behoben werden, um sich bei einem Vorschaufeature zu registrieren, wenn sie noch nicht mit einer integrierten Richtliniendefinition registriert wurden. Beachten Sie, dass neue Abonnements, die einem vorhandenen Mandanten hinzugefügt wurden, nicht automatisch registriert werden.

Nächste Schritte

• Informationen zur Verwendung von REST-API-Aufrufen sowie zum Auflisten, Registrieren oder Aufheben der Registrierung von Previewfunktionen finden Sie in der Dokumentation der Features.
• Weitere Informationen zum Registrieren eines Ressourcenanbieters finden Sie unter Azure-Ressourcenanbieter und -typen.
• Eine Liste, die Ressourcenanbieter zu Azure-Diensten zuordnet, finden Sie unter Ressourcenanbieter für Azure-Dienste.