Konfigurera förhandsversionsfunktioner i Azure-prenumeration

Den här artikeln visar hur du hanterar förhandsgranskningsfunktioner i din Azure-prenumeration. Med förhandsversionsfunktioner kan du välja nya funktioner innan den släpps. Vissa förhandsversionsfunktioner ä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örhandsversionsfunktioner.

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, delstat 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 Oregistrerad.
   • 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

Om du vill visa alla förhandsversionsfunktioner för prenumerationen använder du cmdleten Get-AzProviderFeature .

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örhandsversionsfunktionen

Registrera en förhandsgranskningsfunktion i din Azure-prenumeration för att visa 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örhandsgranskningsfunktionen. Vanligtvis begär du åtkomst via en supportbegäran.
  • 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äran. Information om hur du får åtkomst finns i meddelanden om förhandsversionsfunktionen.

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 Register (Registrera).

   

7. Välj OK.

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

Azure CLI

Om du vill registrera en förhandsgranskningsfunktion 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

Anteckning

När registerkommandot körs visas ett meddelande om att när funktionen har registrerats az provider register --namespace <provider-name> körs den för att sprida ändringarna.

PowerShell

Om du vill registrera en förhandsversionsfunktion 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örhandsversionsfunktionen

När du är klar med en förhandsgranskningsfunktion avregistrerar du den från din Azure-prenumeration. Du kanske ser två olika statusar när du har avregistrerat funktionen. Om du avregistrerar via portalen anges statusen till Inte registrerad. Om du avregistrerar via Azure CLI, PowerShell eller REST API anges statusen till Avregistrerad. Statusen är annorlunda 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 registrerat.

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örhandsgranskningsfunktion använder du kommandot az feature unregister . Tillståndet RegistrationState ändras till Oregistrerad.

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

Anteckning

När kommandot avregistreras visas ett meddelande om att när funktionen har avregistrerats körs az provider register --namespace <provider-name> den för att sprida ändringarna.

Använd följande kommando för att hitta oregistrerade förhandsgranskningsfunktioner. Ersätt <ResourceProvider.Name> med ett providernamn som Microsoft.Compute.

I följande exempel visas en funktion för oregistrerad förhandsgranskning 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 Oregistrerad.

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 oregistrerad förhandsgranskning för Microsoft.Compute resursprovidern.

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

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

Nästa steg

• Information om hur du använder REST API-anrop och listar, registrerar eller avregistrerar 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.