다음을 통해 공유


Start-AzFrontDoorCdnProfilePrepareMigration

클래식 AFD 인스턴스를 Azure Front Door(표준/프리미엄) 프로필로 마이그레이션합니다. Front Door에 WAF 정책이 있는 경우 MigrationWebApplicationFirewallMapping이 연결되어야 합니다. 프런트 도어에 고객 인증서가 있는 경우 관리 ID를 연결해야 합니다. 이 후에 변경 사항을 커밋해야 합니다.

구문

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>]

Description

클래식 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 정책에 복사하는 경우 새 WAF 정책은 클래식 AFD 인스턴스를 사용하여 동일한 구독 및 리소스 그룹에 만들어야 합니다. 클래식 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
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ClassicResourceReferenceId

클래식 Front Door 인스턴스의 리소스 ID입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:PSObject
별칭:AzureRMContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-IdentityType

관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우).

형식:ManagedServiceIdentityType
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-IdentityUserAssignedIdentity

리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다.

형식:Hashtable
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-MigrationWebApplicationFirewallMapping

마이그레이션된 프로필에 대한 Waf 매핑을 생성하려면 MIGRATIONWEBAPPLICATIONFIREWALLMAPPING 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

형식:IMigrationWebApplicationFirewallMapping[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-NoWait

명령을 비동기적으로 실행

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ProfileName

만들어야 하는 새 AFD 표준/프리미엄 프로필의 이름입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ResourceGroupName

Azure 구독 내의 리소스 그룹의 이름입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SkuName

가격 책정 계층의 이름입니다.

형식:SkuName
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SubscriptionId

Azure 구독 ID입니다.

형식:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

출력

IMigrateResult