Configurare le funzionalità di anteprima nella sottoscrizione di Azure

Articolo
2025-02-12

Questo articolo illustra come gestire le funzionalità di anteprima nella sottoscrizione di Azure. Le funzionalità di anteprima consentono di acconsentire esplicitamente alle nuove funzionalità prima del rilascio. Alcune funzionalità di anteprima sono disponibili per chiunque voglia provarle. Altre funzionalità di anteprima richiedono l'approvazione del team del prodotto.

Il controllo AFEC (Azure Feature Exposure Control) di Azure è disponibile tramite lo spazio dei nomi Microsoft.Features. Le funzionalità di anteprima hanno il formato seguente per l'ID risorsa:

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

Accesso obbligatorio

Per elencare, registrare o annullare la registrazione delle funzionalità di anteprima nella sottoscrizione di Azure, è necessario accedere alle azioni Microsoft.Features/*. Questa autorizzazione viene concessa tramite i ruoli predefiniti Collaboratore e Proprietario. È anche possibile specificare l'accesso necessario tramite un ruolo personalizzato.

Elencare le funzionalità di anteprima

È possibile elencare tutte le funzionalità di anteprima e i relativi stati di registrazione per una sottoscrizione di Azure.

Nota

Il portale mostra solo una funzionalità di anteprima quando il servizio proprietario della funzionalità acconsente esplicitamente all'esperienza di gestione delle funzionalità di anteprima. Se la funzionalità che si sta cercando non viene visualizzata nell'elenco, è consigliabile usare l'interfaccia della riga di comando di Azure e Azure PowerShell.

Accedere al portale di Azure.
Nella casella di ricerca immettere sottoscrizioni e selezionare Sottoscrizioni.
Selezionare il collegamento per il nome della sottoscrizione.
Nel menu a sinistra, in Impostazioni selezionare Funzionalità di anteprima.
Viene visualizzato un elenco delle funzionalità di anteprima disponibili e lo stato di registrazione corrente.
Dalle funzionalità di anteprima è possibile filtrare l'elenco in base al nome, allo stato o al tipo:
- Nome: deve contenere testo del nome della funzionalità di anteprima, non del nome visualizzato.
- Stato: selezionare il menu a discesa e scegliere uno stato. Il portale non filtra in base a Registrazione annullata.
- Tipo: selezionare il menu a discesa e scegliere un tipo.

Per elencare tutte le funzionalità di anteprima della sottoscrizione, usare il comando az feature list.

L'output predefinito per l'interfaccia della riga di comando di Azure è JSON. Per altre informazioni su ulteriori formati di output, vedere Formati di output per i comandi dell'interfaccia della riga di comando di Azure.

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

Per filtrare l'output per un provider di risorse specifico, usare il parametro namespace. In questo esempio, il parametro output specifica un formato di tabella.

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

Per filtrare l'output per una funzionalità di anteprima specifica, usare il comando az feature show.

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

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

Per elencare tutte le funzionalità di anteprima della sottoscrizione, usare il 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

Per filtrare l'output per un provider di risorse specifico, usare il parametro ProviderNamespace. L'output predefinito mostra solo le funzionalità registrate. Per visualizzare tutte le funzionalità di anteprima per un provider di risorse, usare il parametro ListAvailable con il parametro 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

È possibile filtrare l'output per una funzionalità di anteprima specifica usando il parametro FeatureName.

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

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

Registrare la funzionalità di anteprima

Per esporre altre funzionalità per un provider di risorse, registrare una funzionalità di anteprima nella sottoscrizione di Azure. Alcune funzionalità di anteprima richiedono l'approvazione.

Dopo aver registrato una funzionalità di anteprima nella sottoscrizione, viene visualizzato uno dei due stati Registrati o In sospeso.

Per una funzionalità di anteprima che non richiede l'approvazione, lo stato è Registrato.
Se una funzionalità di anteprima richiede l'approvazione, lo stato di registrazione è In sospeso. È necessario richiedere l'approvazione al servizio di Azure che offre la funzionalità di anteprima. In genere si richiede l'accesso tramite un ticket di supporto.
- Per richiedere l'approvazione, inviare una richiesta di supporto di Azure.
- Dopo l'approvazione della registrazione, lo stato della funzionalità di anteprima diventa Registrato.

Alcuni servizi richiedono altri metodi, ad esempio la posta elettronica, per ottenere l'approvazione per le richieste in sospeso. Controllare gli annunci relativi alla funzionalità di anteprima per informazioni su come ottenere l'accesso.

Accedere al portale di Azure.
Nella casella di ricerca immettere sottoscrizioni e selezionare Sottoscrizioni.
Selezionare il collegamento per il nome della sottoscrizione.
Nel menu a sinistra, in Impostazioni selezionare Funzionalità di anteprima.
Selezionare il collegamento per la funzionalità di anteprima che si vuole registrare.
Selezionare Registra.
Seleziona OK.

La schermata Funzionalità di anteprima verrà aggiornata e verrà visualizzato lo stato della funzionalità.

Per registrare una funzionalità di anteprima, usare il comando 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"
}

Per visualizzare lo stato della registrazione, usare il comando az feature show.

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

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

Nota

Quando si esegue il comando register, viene restituito un messaggio che suggerisce l'esecuzione az provider register --namespace <provider-name> dopo la registrazione della funzionalità per propagare le modifiche.

Per registrare una funzionalità di anteprima, usare il cmdlet Register-AzProviderFeature.

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

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

Per visualizzare lo stato della registrazione, usare il cmdlet Get-AzProviderFeature.

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

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

Annullare la registrazione della funzionalità di anteprima

Al termine dell'uso di una funzionalità di anteprima, annullare la registrazione dalla sottoscrizione di Azure. È possibile notare due stati diversi dopo l'annullamento della registrazione della funzionalità. Se si annulla la registrazione tramite il portale, lo stato non è registrato. Se si annulla la registrazione tramite l'interfaccia della riga di comando di Azure, PowerShell o l'API REST, lo stato è Annulla registrazione. Lo stato è diverso perché il portale elimina la registrazione della funzionalità, mentre i comandi annullano la registrazione. In entrambi i casi, la funzionalità non è più disponibile nella sottoscrizione. È possibile acconsentire esplicitamente nuovamente alla funzionalità registrandola nuovamente.

È possibile annullare la registrazione delle funzionalità di anteprima da Funzionalità di anteprima. Lo stato cambia in Non registrato.

Accedere al portale di Azure.
Nella casella di ricerca immettere sottoscrizioni e selezionare Sottoscrizioni.
Selezionare il collegamento per il nome della sottoscrizione.
Nel menu a sinistra, in Impostazioni selezionare Funzionalità di anteprima.
Selezionare il collegamento per la funzionalità di anteprima per la quale si vuole annullare la registrazione.
Selezionare Annulla registrazione
Seleziona OK.

Per annullare la registrazione di una funzionalità di anteprima, usare il comando az feature unregister. Lo stato RegistrationState cambia in Registrazione annullata.

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

Per visualizzare lo stato di annullamento della registrazione, usare il comando az feature show.

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

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

Nota

Quando si esegue il comando di annullamento della registrazione, viene restituito un messaggio che suggerisce l'esecuzione az provider register --namespace <provider-name> dopo la registrazione della funzionalità per propagare le modifiche.

Per trovare le funzionalità di anteprima con registrazione annullata, usare il comando seguente. Sostituire <ResourceProvider.Name> con un nome di provider, ad esempio Microsoft.Compute.

Nell'esempio seguente viene visualizzata una funzionalità di anteprima con registrazione annullata per il provider di risorse Microsoft.Compute.

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

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

Per annullare la registrazione di una funzionalità di anteprima, usare il cmdlet Unregister-AzProviderFeature. Lo stato RegistrationState cambia in Registrazione annullata.

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

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

Per visualizzare lo stato di annullamento della registrazione, usare il cmdlet Get-AzProviderFeature.

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

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

Nell'esempio seguente viene visualizzata una funzionalità di anteprima con registrazione annullata per il provider di risorse Microsoft.Compute.

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

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

Configurazione delle funzionalità di anteprima tramite Criteri di Azure

È possibile correggere le sottoscrizioni per la registrazione a una funzionalità di anteprima se non sono già registrate usando una definizione di criteri predefinita . Quando si aggiungono nuove sottoscrizioni a un tenant esistente, non vengono registrate automaticamente.

Passaggi successivi

Per usare le chiamate API REST ed elencare, registrare o annullare la registrazione delle funzionalità di anteprima, vedere la documentazione Funzionalità.
Per altre informazioni su come registrare un provider di risorse, vedere Provider e tipi di risorse di Azure.
Per un elenco con il mapping dei provider di risorse ai servizi di Azure, vedere provider di risorse per i servizi di Azure.

Condividi tramite

Configurare le funzionalità di anteprima nella sottoscrizione di Azure

Accesso obbligatorio

Elencare le funzionalità di anteprima

Registrare la funzionalità di anteprima

Annullare la registrazione della funzionalità di anteprima

Configurazione delle funzionalità di anteprima tramite Criteri di Azure

Passaggi successivi

Commenti e suggerimenti

Risorse aggiuntive