Konfigurowanie funkcji w wersji zapoznawczej w subskrypcji platformy Azure

Artykuł
04/27/2024

W tym artykule pokazano, jak zarządzać funkcjami w wersji zapoznawczej w ramach subskrypcji platformy Azure. Funkcje w wersji zapoznawczej umożliwiają korzystanie z nowych funkcji przed jej wydaniem. Niektóre funkcje w wersji zapoznawczej są dostępne dla każdego, kto chce wyrazić zgodę. Inne funkcje w wersji zapoznawczej wymagają zatwierdzenia przez zespół produktu.

Kontrola ekspozycji funkcji platformy Azure (AFEC) jest dostępna za pośrednictwem przestrzeni nazw Microsoft.Features . Funkcje w wersji zapoznawczej mają następujący format dla identyfikatora zasobu:

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

Wymagany dostęp

Aby wyświetlić listę, zarejestrować lub wyrejestrować funkcje w wersji zapoznawczej w ramach subskrypcji platformy Azure, musisz uzyskać dostęp do Microsoft.Features/* akcji. To uprawnienie jest przyznawane za pośrednictwem wbudowanych ról Współautor i Właściciel . Możesz również określić wymagany dostęp za pośrednictwem roli niestandardowej.

Wyświetlanie listy funkcji w wersji zapoznawczej

Możesz wyświetlić listę wszystkich funkcji w wersji zapoznawczej i ich stanów rejestracji dla subskrypcji platformy Azure.

Portal pokazuje tylko funkcję w wersji zapoznawczej, gdy usługa będąca właścicielem funkcji jawnie zdecydowała się na środowisko zarządzania funkcjami w wersji zapoznawczej.

Zaloguj się w witrynie Azure Portal.
W polu wyszukiwania wprowadź subskrypcje i wybierz pozycję Subskrypcje.
Wybierz link dla nazwy subskrypcji.
W menu po lewej stronie w obszarze Ustawienia wybierz pozycję Funkcje w wersji zapoznawczej.
Zostanie wyświetlona lista dostępnych funkcji w wersji zapoznawczej i bieżący stan rejestracji.
W obszarze Funkcje w wersji zapoznawczej można filtrować listę według nazwy, stanu lub typu:
- Filtruj według nazwy: musi zawierać tekst z nazwy funkcji w wersji zapoznawczej, a nie nazwy wyświetlanej.
- Stan: wybierz menu rozwijane i wybierz stan. Portal nie filtruje według wyrejestrowanej.
- Typ: wybierz menu rozwijane i wybierz typ.

Aby wyświetlić listę wszystkich funkcji w wersji zapoznawczej subskrypcji, użyj polecenia az feature list .

Domyślne dane wyjściowe interfejsu wiersza polecenia platformy Azure to JSON. Aby uzyskać więcej informacji na temat innych formatów danych wyjściowych, zobacz Formaty danych wyjściowych dla poleceń interfejsu wiersza polecenia platformy Azure.

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

Aby filtrować dane wyjściowe dla określonego dostawcy zasobów, użyj parametru namespace . W tym przykładzie output parametr określa format tabeli.

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

Aby filtrować dane wyjściowe dla określonej funkcji w wersji zapoznawczej, użyj polecenia az feature show .

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

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

Aby wyświetlić listę wszystkich funkcji subskrypcji w wersji zapoznawczej, użyj polecenia 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

Aby filtrować dane wyjściowe dla określonego dostawcy zasobów, użyj parametru ProviderNamespace . Domyślne dane wyjściowe zawierają tylko zarejestrowane funkcje. Aby wyświetlić wszystkie funkcje wersji zapoznawczej dostawcy zasobów, użyj ListAvailable parametru z parametrem 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

Dane wyjściowe można filtrować pod kątem określonej funkcji w wersji zapoznawczej przy użyciu parametru FeatureName .

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

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

Rejestrowanie funkcji w wersji zapoznawczej

Zarejestruj funkcję w wersji zapoznawczej w subskrypcji platformy Azure, aby uwidocznić więcej funkcji dostawcy zasobów. Niektóre funkcje w wersji zapoznawczej wymagają zatwierdzenia.

Po zarejestrowaniu funkcji w wersji zapoznawczej w ramach subskrypcji zobaczysz jeden z dwóch stanów: Zarejestrowany lub Oczekujący.

W przypadku funkcji w wersji zapoznawczej, która nie wymaga zatwierdzenia, stan to Zarejestrowane.
Jeśli funkcja w wersji zapoznawczej wymaga zatwierdzenia, stan rejestracji to Oczekiwanie. Musisz zażądać zatwierdzenia od usługi platformy Azure oferującej funkcję w wersji zapoznawczej. Zazwyczaj żądasz dostępu za pośrednictwem biletu pomocy technicznej.
- Aby zażądać zatwierdzenia, prześlij żądanie pomoc techniczna platformy Azure.
- Po zatwierdzeniu rejestracji stan funkcji w wersji zapoznawczej zmieni się na Zarejestrowany.

Niektóre usługi wymagają innych metod, takich jak poczta e-mail, aby uzyskać zatwierdzenie oczekującego żądania. Sprawdź ogłoszenia dotyczące funkcji w wersji zapoznawczej, aby uzyskać informacje o sposobie uzyskiwania dostępu.

Zaloguj się w witrynie Azure Portal.
W polu wyszukiwania wprowadź subskrypcje i wybierz pozycję Subskrypcje.
Wybierz link dla nazwy subskrypcji.
W menu po lewej stronie w obszarze Ustawienia wybierz pozycję Funkcje w wersji zapoznawczej.
Wybierz link dla funkcji w wersji zapoznawczej, którą chcesz zarejestrować.
Wybierz pozycję Zarejestruj.
Wybierz przycisk OK.

Zostanie wyświetlony ekran Funkcje w wersji zapoznawczej i stan funkcji w wersji zapoznawczej.

Aby zarejestrować funkcję w wersji zapoznawczej, użyj polecenia 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"
}

Aby wyświetlić stan rejestracji, użyj az feature show polecenia .

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

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

Uwaga

Po uruchomieniu polecenia register zostanie wyświetlony komunikat, że po zarejestrowaniu funkcji, aby uruchomić az provider register --namespace <provider-name> polecenie w celu propagowania zmian.

Aby zarejestrować funkcję w wersji zapoznawczej, użyj polecenia cmdlet Register-AzProviderFeature .

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

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

Aby wyświetlić stan rejestracji, użyj Get-AzProviderFeature polecenia cmdlet .

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

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

Wyrejestrowywanie funkcji w wersji zapoznawczej

Po zakończeniu korzystania z funkcji w wersji zapoznawczej wyrejestruj ją z subskrypcji platformy Azure. Po wyrejestrowaniu funkcji można zauważyć dwa różne stany. Jeśli wyrejestrujesz się za pośrednictwem portalu, stan zostanie ustawiony na Niezarejestrowany. Jeśli wyrejestrujesz się za pomocą interfejsu wiersza polecenia platformy Azure, programu PowerShell lub interfejsu API REST, stan zostanie ustawiony na Wyrejestrowany. Stan jest inny, ponieważ portal usuwa rejestrację funkcji, ale polecenia wyrejestrowywały tę funkcję. W obu przypadkach funkcja nie jest już dostępna w twojej subskrypcji. W obu przypadkach możesz ponownie wyrazić zgodę na tę funkcję, ponownie rejestrując ją.

Funkcje w wersji zapoznawczej można wyrejestrować z funkcji w wersji zapoznawczej. Stan zmieni się na Niezarejestrowany.

Zaloguj się w witrynie Azure Portal.
W polu wyszukiwania wprowadź subskrypcje i wybierz pozycję Subskrypcje.
Wybierz link dla nazwy subskrypcji.
W menu po lewej stronie w obszarze Ustawienia wybierz pozycję Funkcje w wersji zapoznawczej.
Wybierz link dla funkcji w wersji zapoznawczej, którą chcesz wyrejestrować.
Wybierz pozycję Wyrejestruj.
Wybierz przycisk OK.

Aby wyrejestrować funkcję w wersji zapoznawczej, użyj polecenia az feature unregister . Stan RegistrationState zmienia się na Wyrejestrowany.

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

Aby wyświetlić stan wyrejestrowania, użyj az feature show polecenia .

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

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

Uwaga

Po uruchomieniu polecenia wyrejestrowania zostanie wyświetlony komunikat informujący o tym, że po wyrejestrowanej funkcji uruchom az provider register --namespace <provider-name> polecenie w celu propagowania zmian.

Aby znaleźć niezarejestrowane funkcje w wersji zapoznawczej, użyj następującego polecenia. Zastąp <ResourceProvider.Name> ciąg nazwą dostawcy, taką jak Microsoft.Compute.

W poniższym przykładzie przedstawiono funkcję wyrejestrowanej wersji zapoznawczej dostawcy Microsoft.Compute zasobów.

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

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

Aby wyrejestrować funkcję w wersji zapoznawczej, użyj polecenia cmdlet Unregister-AzProviderFeature . Stan RegistrationState zmienia się na Wyrejestrowany.

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

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

Aby wyświetlić stan wyrejestrowania, użyj Get-AzProviderFeature polecenia cmdlet .

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

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

W poniższym przykładzie przedstawiono funkcję wyrejestrowanej wersji zapoznawczej dostawcy Microsoft.Compute zasobów.

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

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

Konfigurowanie funkcji w wersji zapoznawczej przy użyciu usługi Azure Policy

Subskrypcje można skorygować w celu zarejestrowania się w funkcji w wersji zapoznawczej, jeśli nie zostały jeszcze zarejestrowane przy użyciu wbudowanej definicji zasad. Pamiętaj, że nowe subskrypcje dodane do istniejącej dzierżawy nie zostaną automatycznie zarejestrowane.

Następne kroki

Aby używać wywołań i list interfejsu API REST, rejestrowania lub wyrejestrowania funkcji w wersji zapoznawczej, zobacz dokumentację funkcji .
Aby uzyskać więcej informacji na temat rejestrowania dostawcy zasobów, zobacz Dostawcy zasobów i typy platformy Azure.
Aby uzyskać listę mapowania dostawców zasobów na usługi platformy Azure, zobacz Dostawcy zasobów dla usług platformy Azure.