你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Start-AzFrontDoorCdnProfilePrepareMigration

模块:

Az.Cdn

将经典 AFD 实例迁移到 Azure Front Door（标准/高级）配置文件。 如果 front door 具有 WAF 策略，则迁移WebApplicationFirewallMapping 应关联。 如果 frontdoor 具有客户证书，则应关联托管标识。 需要在此之后提交更改。

语法

Start-AzFrontDoorCdnProfilePrepareMigration
     -ResourceGroupName <String>
     [-SubscriptionId <String>]
     -ClassicResourceReferenceId <String>
     -ProfileName <String>
     -SkuName <SkuName>
     [-MigrationWebApplicationFirewallMapping <IMigrationWebApplicationFirewallMapping[]>]
     [-IdentityType <ManagedServiceIdentityType>]
     [-IdentityUserAssignedIdentity <Hashtable>]
     [-DefaultProfile <PSObject>]
     [-AsJob]
     [-NoWait]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

说明

将经典 AFD 实例迁移到 Azure Front Door（标准/高级）配置文件。 需要在此之后提交更改。

示例

示例 1：在没有 WAF 策略的情况下关联的经典 AFD 实例，并且没有客户证书。

Start-AzFrontDoorCdnProfilePrepareMigration -ResourceGroupName rgName -ClassicResourceReferenceId /subscriptions/testSubId/resourcegroups/rgName/providers/Microsoft.Network/Frontdoors/name -ProfileName name-migrated -SkuName Standard_AzureFrontDoor

MigratedProfileResourceId
-------------------------
/subscriptions/testSubId/resourceGroups/rgName/providers/Microsoft.Cdn/profiles/name-migrated

如果没有 WAF 策略关联的经典 AFD 实例，并且没有客户证书。 将经典 AFD 迁移到 Azure Front Door（标准/高级版）配置文件。 需要在此之后提交更改。

示例 2：与 WAF 关联的经典 AFD 实例并复制到新的 WAF 策略时。

$wafMapping = New-AzFrontDoorCdnMigrationWebApplicationFirewallMappingObject -MigratedFromId /subscriptions/testSubId/resourcegroups/rgName01/providers/Microsoft.Network/frontdoorwebapplicationfirewallpolicies/waf01 -MigratedToId /subscriptions/testSubId/resourcegroups/rgName/providers/Microsoft.Network/frontdoorwebapplicationfirewallpolicies/newWAFName
Start-AzFrontDoorCdnProfilePrepareMigration -ResourceGroupName rgName -ClassicResourceReferenceId /subscriptions/testSubId/resourcegroups/rgName/providers/Microsoft.Network/Frontdoors/name -ProfileName name-migrated -SkuName Standard_AzureFrontDoor -MigrationWebApplicationFirewallMapping $wafMapping

MigratedProfileResourceId
-------------------------
/subscriptions/testSubId/resourceGroups/rgName/providers/Microsoft.Cdn/profiles/name-migrated

与 WAF 关联的经典 AFD 实例并复制到新的 WAF 策略时。 应在具有经典 AFD 实例的同一订阅和资源组中创建新的 WAF 策略。 将经典 AFD 迁移到 Azure Front Door（标准/高级）配置文件。 需要在此之后提交更改。

示例 3：与 WAF 关联的经典 AFD 实例并选择现有的 WAF 策略时。

$wafMapping = New-AzFrontDoorCdnMigrationWebApplicationFirewallMappingObject -MigratedFromId /subscriptions/testSubId/resourcegroups/rgName01/providers/Microsoft.Network/frontdoorwebapplicationfirewallpolicies/waf01 -MigratedToId /subscriptions/testSubId/resourcegroups/rgName02/providers/Microsoft.Network/frontdoorwebapplicationfirewallpolicies/existingWAFName
Start-AzFrontDoorCdnProfilePrepareMigration -ResourceGroupName rgName -ClassicResourceReferenceId /subscriptions/testSubId/resourcegroups/rgName/providers/Microsoft.Network/Frontdoors/name -ProfileName name-migrated -SkuName Standard_AzureFrontDoor -MigrationWebApplicationFirewallMapping $wafMapping

MigratedProfileResourceId
-------------------------
/subscriptions/testSubId/resourceGroups/rgName/providers/Microsoft.Cdn/profiles/name-migrated

与 WAF 关联的经典 AFD 实例并选择现有的 WAF 策略时。 只能选择与经典 AFD 实例位于同一订阅中的 WAF 策略。 将经典 AFD 迁移到 Azure Front Door（标准/高级版）配置文件。 需要在此之后提交更改。

示例 4：当与多个 WAF 策略关联的经典 AFD 实例且没有客户证书时。

$wafMapping1 = New-AzFrontDoorCdnMigrationWebApplicationFirewallMappingObject -MigratedFromId /subscriptions/testSubId/resourcegroups/rgName01/providers/Microsoft.Network/frontdoorwebapplicationfirewallpolicies/waf01 -MigratedToId /subscriptions/testSubId/resourcegroups/rgName01/providers/Microsoft.Network/frontdoorwebapplicationfirewallpolicies/waf01test

$wafMapping2 = New-AzFrontDoorCdnMigrationWebApplicationFirewallMappingObject -MigratedFromId /subscriptions/testSubId/resourcegroups/rgName02/providers/Microsoft.Network/frontdoorwebapplicationfirewallpolicies/waf02 -MigratedToId  /subscriptions/testSubId/resourcegroups/rgName02/providers/Microsoft.Network/frontdoorwebapplicationfirewallpolicies/waf02test

# enable Managed Identity via SystemAssigned and UserAssigned
$identityType = "SystemAssigned, UserAssigned"

# UserIdentity information
$userInfo = @{
	"/subscriptions/testSubId/resourceGroups/rgName01/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity01" = @{}
	"/subscriptions/testSubId/resourceGroups/rgName02/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity02" = @{}
}

Start-AzFrontDoorCdnProfilePrepareMigration -ResourceGroupName rgName -ClassicResourceReferenceId /subscriptions/testSubId/resourcegroups/rgName/providers/Microsoft.Network/Frontdoors/name -ProfileName name-migrated -SkuName Premium_AzureFrontDoor -MigrationWebApplicationFirewallMapping @($wafMapping1, $wafMapping2) -IdentityType $identityType -IdentityUserAssignedIdentity $userInfo

MigratedProfileResourceId
-------------------------
/subscriptions/testSubId/resourceGroups/rgName/providers/Microsoft.Cdn/profiles/name-migrated

当与多个 WAF 策略关联的经典 AFD 实例且没有客户证书时。 将经典 AFD 迁移到 Azure Front Door（标准/高级版）配置文件。 需要在此之后提交更改。

示例 5：当经典 AFD 实例未与 WAF 关联且没有客户证书时，经典 AFD 实例的订阅与本地子实体不同。

Start-AzFrontDoorCdnProfilePrepareMigration -ResourceGroupName rgName -ClassicResourceReferenceId /subscriptions/testSubId01/resourcegroups/rgName/providers/Microsoft.Network/Frontdoors/name -ProfileName name-migrated -SkuName Standard_AzureFrontDoor -SubscriptionId testSubId01

MigratedProfileResourceId
-------------------------
/subscriptions/testSubId/resourceGroups/rgName/providers/Microsoft.Cdn/profiles/name-migrated

当经典 AFD 实例未与 WAF 关联且没有客户证书时，经典 AFD 实例的订阅与本地子证书不同。 将经典 AFD 迁移到 Azure Front Door（标准/高级版）配置文件。 需要在此之后提交更改。

参数

-AsJob

以作业身份运行命令

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ClassicResourceReferenceId

经典前门实例的资源 ID。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:	PSObject
别名:	AzureRMContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IdentityType

托管服务标识的类型（其中允许 SystemAssigned 和 UserAssigned 类型）。

类型:	ManagedServiceIdentityType
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IdentityUserAssignedIdentity

与资源关联的用户分配标识集。 userAssignedIdentities 字典密钥将为 ARM 资源 ID，格式为“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。 字典值可以是请求中的空对象（{}）。

类型:	Hashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MigrationWebApplicationFirewallMapping

要构造的已迁移配置文件的 Waf 映射，请参阅 MIGRATIONWEBAPPLICATIONFIREWALLMAPPING 属性的 NOTES 部分，并创建哈希表。

类型:	IMigrationWebApplicationFirewallMapping[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NoWait

异步运行命令

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ProfileName

需要创建的新 AFD 标准/高级配置文件的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

Azure 订阅中的资源组的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SkuName

定价层的名称。

类型:	SkuName
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SubscriptionId

Azure 订阅 ID。

类型:	String
Position:	Named
默认值:	(Get-AzContext).Subscription.Id
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输出

IMigrateResult