ترحيل Azure Front Door (كلاسيكي) إلى المستوى القياسي/المتميز باستخدام Azure PowerShell

قم بتشغيل الأمر Start-AzFrontDoorCdnProfilePrepareMigration للتحضير للترحيل. استبدل قيم اسم مجموعة الموارد، ومعرف المورد، واسم ملف التعريف بالقيم الخاصة بك. بالنسبة إلى SkuName ، استخدم إما Standard_AzureFrontDoor أو Premium_AzureFrontDoor. يستند SkuName إلى الإخراج من الأمر Test-AzFrontDoorCdnProfileMigration.

استبدل القيم التالية في الأمر:

• <subscriptionId>: معرف اشتراكك.
• <resourceGroupName>: اسم مجموعة الموارد للواجهة الأمامية (الكلاسيكية).
• <frontdoorClassicName>: اسم ملف تعريف Front Door (الكلاسيكي).

Start-AzFrontDoorCdnProfilePrepareMigration -ResourceGroupName <resourceGroupName> -ClassicResourceReferenceId /subscriptions/<subscriptionId>/resourcegroups/<resourceGroupName>/providers/Microsoft.Network/frontdoors/<frontdoorClassicName> -ProfileName myAzureFrontDoor -SkuName Premium_AzureFrontDoor

يبدو الإخراج مشابهاً للنص التالي:

Starting the parameter validation process.
The parameters have been successfully validated.
Your new Front Door profile is being created. Please wait until the process has finished completely. This may take several minutes.

Your new Front Door profile with the configuration has been successfully created.

1. قم بتشغيل الأمر Get-AzFrontDoorWafPolicy للحصول على معرف المورد لنهج WAF الخاص بك. استبدل قيم اسم مجموعة الموارد واسم نهج WAF بالقيم الخاصة بك.

   Get-AzFrontDoorWafPolicy -ResourceGroupName myAFDResourceGroup -Name myClassicFrontDoorWAF
   

   يبدو الإخراج مشابهاً للنص التالي:

   PolicyMode                    : Detection
   PolicyEnabledState            : Enabled
   RedirectUrl                   : 
   CustomBlockResponseStatusCode : 403
   CustomBlockResponseBody       : 
   RequestBodyCheck              : Disabled
   CustomRules                   : {}
   ManagedRules                  : {Microsoft.Azure.Commands.FrontDoor.Models.PSAzureManagedRule}
   Etag                          : 
   ProvisioningState             : Succeeded
   Sku                           : Classic_AzureFrontDoor
   Tags                          : 
   Id                            : /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/myAFDResourceGroup/providers/Microsoft.Network/frontdoorwebapplicationfirewallpolicies/myClassicFrontDoorWAF
   Name                          : myFrontDoorWAF
   Type                          :
   

2. قم بتشغيل الأمر New-AzFrontDoorCdnMigrationWebApplicationFirewallMappingObject لإنشاء كائن في الذاكرة لترحيل نهج WAF. استخدم معرف WAF في الخطوة الأخيرة ل MigratedFromId. لاستخدام نهج WAF موجود، استبدل القيمة بمعرف MigratedToId مورد لنهج WAF الذي يطابق مستوى Front Door الذي تقوم بالترحيل إليه. إذا كنت تقوم بإنشاء نسخة نهج WAF جديدة، يمكنك تغيير اسم نهج WAF في معرف المورد.

   $wafMapping = New-AzFrontDoorCdnMigrationWebApplicationFirewallMappingObject -MigratedFromId /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/myAFDResourceGroup/providers/Microsoft.Network/frontdoorwebapplicationfirewallpolicies/myClassicFrontDoorWAF -MigratedToId  /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/myAFDResourceGroup/providers/Microsoft.Network/frontdoorwebapplicationfirewallpolicies/myFrontDoorWAF
   
   

3. قم بتشغيل الأمر Start-AzFrontDoorCdnProfilePrepareMigration للتحضير للترحيل. استبدل قيم اسم مجموعة الموارد، ومعرف المورد، واسم ملف التعريف بالقيم الخاصة بك. بالنسبة إلى SkuName ، استخدم إما Standard_AzureFrontDoor أو Premium_AzureFrontDoor. يستند SkuName إلى الإخراج من الأمر Test-AzFrontDoorCdnProfileMigration.

   استبدل القيم التالية في الأمر:

   • <subscriptionId>: معرف اشتراكك.
   • <resourceGroupName>: اسم مجموعة الموارد للواجهة الأمامية (الكلاسيكية).
   • <frontdoorClassicName>: اسم ملف تعريف Front Door (الكلاسيكي).

   Start-AzFrontDoorCdnProfilePrepareMigration -ResourceGroupName <resourceGroupName> -ClassicResourceReferenceId /subscriptions/<subscriptionId>/resourcegroups/<resourceGroupName>/providers/Microsoft.Network/frontdoors/<frontdoorClassicName> -ProfileName myAzureFrontDoor -SkuName Premium_AzureFrontDoor -MigrationWebApplicationFirewallMapping $wafMapping
   

   يبدو الإخراج مشابهاً للنص التالي:

   Starting the parameter validation process.
   The parameters have been successfully validated.
   Your new Front Door profile is being created. Please wait until the process has finished completely. This may take several minutes.
   
   Your new Front Door profile with the configuration has been successfully created.
   

إذا كنت تقوم بترحيل ملف تعريف Front Door باستخدام BYOC، فأنت بحاجة إلى تمكين الهوية المدارة في ملف تعريف Front Door. تحتاج إلى منح ملف تعريف Front Door حق الوصول إلى مخزن المفاتيح حيث يتم تخزين الشهادة.

قم بتشغيل الأمر Start-AzFrontDoorCdnProfilePrepareMigration للتحضير للترحيل. استبدل قيم اسم مجموعة الموارد، ومعرف المورد، واسم ملف التعريف بالقيم الخاصة بك. بالنسبة إلى SkuName ، استخدم إما Standard_AzureFrontDoor أو Premium_AzureFrontDoor. يستند SkuName إلى الإخراج من الأمر Test-AzFrontDoorCdnProfileMigration.

النظام المعين

بالنسبة ل IdentityType ، استخدم SystemAssigned.

Start-AzFrontDoorCdnProfilePrepareMigration -ResourceGroupName myAFDResourceGroup -ClassicResourceReferenceId /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/myAFDResourceGroup/providers/Microsoft.Network/Frontdoors/myAzureFrontDoorClassic -ProfileName myAzureFrontDoor -SkuName Premium_AzureFrontDoor -IdentityType SystemAssigned

المستخدم المعين

1. قم بتشغيل الأمر Get-AzUserAssignedIdentity للحصول على معرف المورد للهوية المعينة من قبل المستخدم.

   $id = Get-AzUserAssignedIdentity -ResourceGroupName myResourceGroup -Name afduseridentity
   $id.Id
   

   يبدو الإخراج مشابهاً للنص التالي:

   /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/myAFDResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/afduseridentity
   

2. بالنسبة ل IdentityType، استخدم UserAssigned و ل IdentityUserAssignedIdentity،* استخدم معرف المورد من الخطوة السابقة.

   استبدل القيم التالية في الأمر:

   • <subscriptionId>: معرف اشتراكك.
   • <resourceGroupName>: اسم مجموعة الموارد للواجهة الأمامية (الكلاسيكية).
   • <frontdoorClassicName>: اسم ملف تعريف Front Door (الكلاسيكي).

   Start-AzFrontDoorCdnProfilePrepareMigration -ResourceGroupName <resourceGroupName> -ClassicResourceReferenceId /subscriptions/<subscriptionId>/resourcegroups/<resourceGroupName>/providers/Microsoft.Network/frontdoors/<frontdoorClassicName> -ProfileName myAzureFrontDoor -SkuName Premium_AzureFrontDoor -IdentityType UserAssigned -IdentityUserAssignedIdentity @{"/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/afduseridentity" = @{}}
   

   يبدو الإخراج مشابهاً للنص التالي:

   Starting the parameter validation process.
   The parameters have been successfully validated.
   Your new Front Door profile is being created. Please wait until the process has finished completely. This may take several minutes.
   
   Your new Front Door profile with the configuration has been successfully created.
   

يوضح هذا المثال كيفية ترحيل ملف تعريف Front Door مع نهج WAF متعددة وتمكين كل من الهوية المعينة من قبل النظام والمستخدم.

1. قم بتشغيل الأمر Get-AzFrontDoorWafPolicy للحصول على معرف المورد لنهج WAF الخاص بك. استبدل قيم اسم مجموعة الموارد واسم نهج WAF بالقيم الخاصة بك.

   Get-AzFrontDoorWafPolicy -ResourceGroupName myAFDResourceGroup -Name myClassicFrontDoorWAF
   

   يبدو الإخراج مشابهاً للنص التالي:

   PolicyMode                    : Detection
   PolicyEnabledState            : Enabled
   RedirectUrl                   : 
   CustomBlockResponseStatusCode : 403
   CustomBlockResponseBody       : 
   RequestBodyCheck              : Disabled
   CustomRules                   : {}
   ManagedRules                  : {Microsoft.Azure.Commands.FrontDoor.Models.PSAzureManagedRule}
   Etag                          : 
   ProvisioningState             : Succeeded
   Sku                           : Classic_AzureFrontDoor
   Tags                          : 
   Id                            : /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/myAFDResourceGroup/providers/Microsoft.Network/frontdoorwebapplicationfirewallpolicies/myClassicFrontDoorWAF
   Name                          : myFrontDoorWAF
   Type                          :
   

2. قم بتشغيل الأمر New-AzFrontDoorCdnMigrationWebApplicationFirewallMappingObject لإنشاء كائن في الذاكرة لترحيل نهج WAF. استخدم معرف WAF في الخطوة الأخيرة ل MigratedFromId. لاستخدام نهج WAF موجود، استبدل القيمة بمعرف MigratedToId مورد لنهج WAF الذي يطابق مستوى Front Door الذي تقوم بالترحيل إليه. إذا كنت تقوم بإنشاء نسخة نهج WAF جديدة، يمكنك تغيير اسم نهج WAF في معرف المورد.

   $wafMapping1 = New-AzFrontDoorCdnMigrationWebApplicationFirewallMappingObject -MigratedFromId /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/myAFDResourceGroup/providers/Microsoft.Network/frontdoorwebapplicationfirewallpolicies/myClassicFrontDoorWAF1 -MigratedToId  /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/myAFDResourceGroup/providers/Microsoft.Network/frontdoorwebapplicationfirewallpolicies/myFrontDoorWAF1
   
   $wafMapping2 = New-AzFrontDoorCdnMigrationWebApplicationFirewallMappingObject -MigratedFromId /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/myAFDResourceGroup/providers/Microsoft.Network/frontdoorwebapplicationfirewallpolicies/myClassicFrontDoorWAF2 -MigratedToId  /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/myAFDResourceGroup/providers/Microsoft.Network/frontdoorwebapplicationfirewallpolicies/myFrontDoorWAF2
   

3. حدد كلا نوعي الهوية المدارة في متغير.

   $identityType = "SystemAssigned, UserAssigned"
   

4. قم بتشغيل الأمر Get-AzUserAssignedIdentity للحصول على معرف المورد للهوية المعينة من قبل المستخدم.

   $id1 = Get-AzUserAssignedIdentity -ResourceGroupName myResourceGroup -Name afduseridentity1
   $id1.Id
   $id2 = Get-AzUserAssignedIdentity -ResourceGroupName myResourceGroup -Name afduseridentity2
   $id2.Id
   

   يبدو الإخراج مشابهاً للنص التالي:

   /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/myAFDResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/afduseridentity1
   /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/myAFDResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/afduseridentity2
   

5. حدد معرف مورد الهوية المعين للمستخدم في متغير.

   $userInfo = @{
       "subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/afduseridentity1" = @{}}
       "subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/afduseridentity2" = @{}}
   }
   

6. قم بتشغيل الأمر Start-AzFrontDoorCdnProfilePrepareMigration للتحضير للترحيل. استبدل قيم اسم مجموعة الموارد، ومعرف المورد، واسم ملف التعريف بالقيم الخاصة بك. بالنسبة إلى SkuName ، استخدم إما Standard_AzureFrontDoor أو Premium_AzureFrontDoor. يستند SkuName إلى الإخراج من الأمر Test-AzFrontDoorCdnProfileMigration. تأخذ المعلمة MigrationWebApplicationFirewallMapping صفيفا من عناصر ترحيل نهج WAF. تأخذ المعلمة IdentityType قائمة مفصولة بفواصل من أنواع الهوية. تأخذ معلمة IdentityUserAssignedIdentity جدول تجزئة لمعرفات موارد الهوية المعينة من قبل المستخدم.

   استبدل القيم التالية في الأمر:

   • <subscriptionId>: معرف اشتراكك.
   • <resourceGroupName>: اسم مجموعة الموارد للواجهة الأمامية (الكلاسيكية).
   • <frontdoorClassicName>: اسم ملف تعريف Front Door (الكلاسيكي).

   Start-AzFrontDoorCdnProfilePrepareMigration -ResourceGroupName <resourceGroupName> -ClassicResourceReferenceId /subscriptions/<subscriptionId>/resourcegroups/<resourceGroupName>/providers/Microsoft.Network/frontdoors/<frontdoorClassicName> -ProfileName myAzureFrontDoor -SkuName Premium_AzureFrontDoor -MigrationWebApplicationFirewallMapping @($wafMapping1, $wafMapping2) -IdentityType $identityType -IdentityUserAssignedIdentity $userInfo
   

   يبدو الإخراج مشابهاً للنص التالي:

   Starting the parameter validation process.
   The parameters have been successfully validated.
   Your new Front Door profile is being created. Please wait until the process has finished completely. This may take several minutes.
   
   Your new Front Door profile with the configuration has been successfully created.
   

قم بتشغيل الأمر Enable-AzFrontDoorCdnProfileMigration لترحيل Front Door (الكلاسيكي).

Enable-AzFrontDoorCdnProfileMigration -ProfileName myAzureFrontDoor -ResourceGroupName myAFDResourceGroup

يبدو الإخراج مشابهاً للنص التالي:

Start to migrate.
This process will disable your Front Door (classic) profile and move all your traffic and configurations to the new Front Door profile.
Migrate succeeded.

قم بتشغيل الأمر Stop-AzFrontDoorCdnProfileMigration لإجهاض عملية الترحيل.

Stop-AzFrontDoorCdnProfileMigration -ProfileName myAzureFrontDoor -ResourceGroupName myAFDResourceGroup

يبدو الإخراج مشابهاً للنص التالي:

Start to abort the migration.
Your new Front Door Profile will be deleted and your existing profile will remain active. WAF policies will not be deleted.
Please wait until the process has finished completely. This may take several minutes.
Abort succeeded.