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 den 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

Portalen visar bara en förhandsgranskningsfunktion när tjänsten som äger funktionen uttryckligen har valt hanteringsupplevelsen för förhandsgranskningsfunktioner.

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/11111111-1111-1111-1111-111111111111/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

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

Registrera en förhandsgranskningsfunktion i din Azure-prenumeration för att exponera fler funktioner för en resursprovider. Vissa förhandsgranskningsfunktioner kräver godkännande.

När en förhandsversionsfunktion har registrerats 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-supportbegä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äran. 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/11111111-1111-1111-1111-111111111111/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 registerkommandot körs visas ett meddelande om att när funktionen har registrerats körs az provider register --namespace <provider-name> för att sprida ändringarna.

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 anges statusen till Inte registrerad. Om du avregistrerar dig via Azure CLI, PowerShell eller REST API anges statusen till 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. I båda fallen kan du 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/11111111-1111-1111-1111-111111111111/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 avregistrera-kommandot körs visas ett meddelande om att när funktionen har avregistrerats körs az provider register --namespace <provider-name> den 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

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

Prenumerationer kan åtgärdas för att registrera sig för en förhandsversionsfunktion om de inte redan har registrerats med hjälp av en inbyggd principdefinition. Observera att nya prenumerationer som läggs till i en befintlig klientorganisation inte registreras 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.