Konfigurera förhandsversionsfunktioner i Azure-prenumeration

Den här artikeln visar hur du hanterar förhandsversionsfunktioner i din Azure-prenumeration. Med förhandsversionsfunktioner kan du välja nya funktioner innan de släpps. Vissa förhandsgranskningsfunktioner är tillgängliga för alla som vill anmäla sig. Andra förhandsgranskningsfunktioner kräver godkännande från produktteamet.

Azure Feature Exposure Control (AFEC) är tillgängligt via namnområdet Microsoft.Features . Förhandsgranskningsfunktionerna har följande format för resurs-ID:t:

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

Nödvändig åtkomst

Om du vill visa, registrera eller avregistrera förhandsversionsfunktioner i din Azure-prenumeration behöver du åtkomst till Microsoft.Features/* åtgärderna. Den här behörigheten beviljas via de inbyggda rollerna Deltagare och Ägare . Du kan också ange nödvändig åtkomst via en anpassad roll.

Visa förhandsgranskningsfunktioner

Du kan visa en lista över alla förhandsversionsfunktioner och deras registreringstillstånd för en Azure-prenumeration.

Portal

Kommentar

Portalen visar bara en förhandsgranskningsfunktion när tjänsten som äger funktionen uttryckligen väljer hanteringsupplevelsen för förhandsgranskningsfunktioner. Om den funktion du letar efter inte visas i listan rekommenderar vi att du använder Azure CLI och Azure PowerShell.

1. Logga in på Azure-portalen.

2. I sökrutan anger du prenumerationer och väljer Prenumerationer.

   

3. Välj länken för prenumerationens namn.

   

4. Välj Förhandsversionsfunktioner under Inställningar på den vänstra menyn.

   

5. Du ser en lista över tillgängliga förhandsgranskningsfunktioner och din aktuella registreringsstatus.

   

6. Från förhandsversionsfunktioner kan du filtrera listan efter namn, tillstånd eller typ:

   • Filtrera efter namn: Måste innehålla text från en förhandsgranskningsfunktions namn, inte visningsnamnet.
   • Tillstånd: Välj den nedrullningsbara menyn och välj ett tillstånd. Portalen filtreras inte efter Avregistrerad.
   • Typ: Välj den nedrullningsbara menyn och välj en typ.

   

Azure CLI

Om du vill visa en lista över alla prenumerationens förhandsversionsfunktioner använder du kommandot az feature list .

Standardutdata för Azure CLI är JSON. Mer information om andra utdataformat finns i Utdataformat för Azure CLI-kommandon.

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"
}

Om du vill filtrera utdata för en specifik resursprovider använder du parametern namespace . I det här exemplet anger parametern output ett tabellformat.

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

Om du vill filtrera utdata för en specifik förhandsgranskningsfunktion använder du kommandot az feature show .

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

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

Azure PowerShell

Använd cmdleten Get-AzProviderFeature om du vill visa alla förhandsversionsfunktioner för prenumerationen.

Get-AzProviderFeature -ListAvailable

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

Om du vill filtrera utdata för en specifik resursprovider använder du parametern ProviderNamespace . Standardutdata visar endast de registrerade funktionerna. Om du vill visa alla förhandsgranskningsfunktioner för en resursprovider använder du parametern ListAvailable med parametern 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

Du kan filtrera utdata för en specifik förhandsgranskningsfunktion med hjälp av parametern FeatureName .

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

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

Registrera förhandsgranskningsfunktion

Om du vill visa fler funktioner för en resursprovider registrerar du en förhandsversionsfunktion i din Azure-prenumeration. Vissa förhandsgranskningsfunktioner kräver godkännande.

När du har registrerat en förhandsgranskningsfunktion i din prenumeration visas ett av två tillstånd: Registrerad eller Väntande.

• För en förhandsgranskningsfunktion som inte kräver godkännande är tillståndet Registrerat.
• Om en förhandsgranskningsfunktion kräver godkännande är registreringstillståndet Väntar. Du måste begära godkännande från Azure-tjänsten som erbjuder förhandsversionsfunktionen. Vanligtvis begär du åtkomst via ett supportärende.
  • Skicka en Azure Support begäran för att begära godkännande.
  • När registreringen har godkänts ändras förhandsgranskningsfunktionens tillstånd till Registrerad.

Vissa tjänster kräver andra metoder, till exempel e-post, för att få godkännande för väntande begäranden. Information om hur du får åtkomst finns i meddelanden om förhandsgranskningsfunktionen.

Portal

1. Logga in på Azure-portalen.

2. I sökrutan anger du prenumerationer och väljer Prenumerationer.

3. Välj länken för prenumerationens namn.

4. Välj Förhandsversionsfunktioner under Inställningar på den vänstra menyn.

5. Välj länken för den förhandsgranskningsfunktion som du vill registrera.

6. Välj Registrera.

   

7. Välj OK.

Skärmen Förhandsgranskningsfunktioner uppdateras och förhandsgranskningsfunktionens tillstånd visas.

Azure CLI

Om du vill registrera en förhandsversionsfunktion använder du kommandot 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"
}

Om du vill visa registreringens status använder du az feature show kommandot .

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

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

Kommentar

När du kör registerkommandot returneras ett meddelande som föreslår att du kör az provider register --namespace <provider-name> när funktionen har registrerats för att sprida ändringarna.

Azure PowerShell

Om du vill registrera en förhandsgranskningsfunktion använder du cmdleten Register-AzProviderFeature .

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

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

Om du vill visa registreringens status använder du cmdleten Get-AzProviderFeature .

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

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

Avregistrera förhandsgranskningsfunktion

När du är klar med en förhandsversionsfunktion avregistrerar du den från din Azure-prenumeration. Du kanske ser två olika statusar när du har avregistrerat funktionen. Om du avregistrerar dig via portalen är statusen Inte registrerad. Om du avregistrerar via Azure CLI, PowerShell eller REST API är statusen Avregistrerad. Statusen skiljer sig eftersom portalen tar bort funktionsregistreringen, men kommandona avregistrerar funktionen. I båda fallen är funktionen inte längre tillgänglig i din prenumeration. Du kan välja funktionen igen genom att registrera den igen.

Portal

Du kan avregistrera förhandsversionsfunktioner från förhandsversionsfunktioner. Tillståndet ändras till Inte registrerad.

1. Logga in på Azure-portalen.

2. I sökrutan anger du prenumerationer och väljer Prenumerationer.

3. Välj länken för prenumerationens namn.

4. Välj Förhandsversionsfunktioner under Inställningar på den vänstra menyn.

5. Välj länken för den förhandsgranskningsfunktion som du vill avregistrera.

6. Välj Avregistrera.

   

7. Välj OK.

Azure CLI

Om du vill avregistrera en förhandsversionsfunktion använder du kommandot az feature unregister . Tillståndet RegistrationState ändras till Avregistrerat.

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"
}

Om du vill visa avregistreringens status använder du az feature show kommandot .

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

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

Kommentar

När du kör avregistrera-kommandot returneras ett meddelande som föreslår att du kör az provider register --namespace <provider-name> när funktionen har registrerats för att sprida ändringarna.

Om du vill hitta oregistrerade förhandsgranskningsfunktioner använder du följande kommando. Ersätt <ResourceProvider.Name> med ett providernamn, till exempel Microsoft.Compute.

I följande exempel visas en funktion för avregistrerad förhandsversion för Microsoft.Compute resursprovidern.

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

Om du vill avregistrera en förhandsgranskningsfunktion använder du cmdleten Unregister-AzProviderFeature . Tillståndet RegistrationState ändras till Avregistrerat.

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

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

Om du vill visa avregistreringens status använder du cmdleten Get-AzProviderFeature .

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

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

I följande exempel visas en funktion för avregistrerad förhandsversion för Microsoft.Compute resursprovidern.

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

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

Konfigurera förhandsversionsfunktioner med Azure Policy

Du kan åtgärda prenumerationer för att registrera dig för en förhandsversionsfunktion om de inte redan har registrerats med hjälp av en inbyggd principdefinition. När du lägger till nya prenumerationer i en befintlig klientorganisation registreras de inte automatiskt.

Nästa steg

• Information om hur du använder REST API-anrop och -lista, registrera eller avregistrera förhandsversionsfunktioner finns i dokumentationen om funktioner .
• Mer information om hur du registrerar en resursprovider finns i Azure-resursprovidrar och typer.
• En lista som mappar resursprovidrar till Azure-tjänster finns i Resursprovidrar för Azure-tjänster.