W tym artykule pokazano, jak zarządzać funkcjami w wersji zapoznawczej w ramach subskrypcji platformy Azure. Funkcje w wersji zapoznawczej umożliwiają wybranie 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.
Uwaga
Portal wyświetla tylko funkcję w wersji zapoznawczej, gdy usługa będąca właścicielem funkcji jawnie decyduje się na środowisko zarządzania funkcjami w wersji zapoznawczej. Jeśli szukana funkcja nie jest wyświetlana na liście, zalecamy użycie interfejsu wiersza polecenia platformy Azure i programu Azure PowerShell.
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/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"
}
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
Aby uwidocznić więcej funkcji dostawcy zasobów, zarejestruj funkcję w wersji zapoznawczej w ramach subskrypcji platformy Azure. Niektóre funkcje w wersji zapoznawczej wymagają zatwierdzenia.
Po zarejestrowaniu funkcji w wersji zapoznawczej w ramach subskrypcji zostanie wyświetlony 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ących żądań. 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/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"
}
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 zwraca komunikat, który sugeruje uruchomienie az provider register --namespace <provider-name> po zarejestrowaniu funkcji 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 to Niezarejestrowany. Jeśli wyrejestrujesz się za pomocą interfejsu wiersza polecenia platformy Azure, programu PowerShell lub interfejsu API REST, stan jest 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. 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/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"
}
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 zwraca on komunikat, który sugeruje uruchomienie az provider register --namespace <provider-name> po zarejestrowaniu funkcji 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
Możesz skorygować subskrypcje, aby zarejestrować się w funkcji w wersji zapoznawczej, jeśli nie zostały jeszcze zarejestrowane przy użyciu wbudowanej definicji zasad. Po dodaniu nowych subskrypcji do istniejącej dzierżawy nie są one automatycznie rejestrowane.
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.