Az 5.0.0 마이그레이션 가이드

아티클
11/07/2024

이 문서에서는 Az 4.0.0에서 5.0.0 버전으로 변경되면서 바뀐 내용에 대해 설명합니다.

Az 5.0.0 마이그레이션 가이드

Az.Aks

New-AzAksCluster

NodeOsType 매개 변수를 더 이상 지원하지 않으며 원래 매개 변수 이름의 별칭을 찾을 수 없습니다. 이는 항상 Linux입니다.
ServicePrincipalIdAndSecret 매개 변수의 ClientIdAndSecret 별칭을 더 이상 지원하지 않습니다.
NodeVmSetType의 기본값은 AvailabilitySet에서 VirtualMachineScaleSets로 변경되었습니다.
NetworkPlugin의 기본값은 none에서 azure로 변경되었습니다.

New-AzAksCluster -ResourceGroupName myResourceGroup -Name myCluster -WindowsProfileAdminUserName azureuser -WindowsProfileAdminUserPassword $cred -NetworkPlugin azure -NodeOsType Linux -ClientIdAndSecret xxx

이후

New-AzAksCluster -ResourceGroupName myResourceGroup -Name myCluster -WindowsProfileAdminUserName azureuser -WindowsProfileAdminUserPassword $cred -NodeVmSetType AvailabilitySet  -ServicePrincipalIdAndSecret xxx

Set-AzAksCluster

ServicePrincipalIdAndSecret 매개 변수의 ClientIdAndSecret 별칭을 더 이상 지원하지 않습니다.

Get-AzAksCluster -ResourceGroupName xxx -Name xxx | Set-AzAksCluster -ClientIdAndSecret xxx

이후

Get-AzAksCluster -ResourceGroupName xxx -Name xxx | Set-AzAksCluster -ServicePrincipalIdAndSecret xxx

Az.ContainerRegistry

New-AzContainerRegistry

StorageAccountName 매개 변수를 더 이상 지원하지 않으며 원래 매개 변수 이름의 별칭을 찾을 수 없습니다.

New-AzContainerRegistry -Name $name -ResourceGroupName $rg -Location $location -SKU Classic -StorageAccountName $storage

이후

Classic은 사용되지 않으며 StorageAccountName은 Classic Container Registry에서만 작동하므로 제거되었습니다.

Az.Functions

Get-AzFunctionApp

Get-AzFunctionApp 매개 변수 세트 하나를 제외한 모든 매개 변수 세트에서 IncludeSlot 스위치 매개 변수가 제거되었습니다. 이제 cmdlet은 -IncludeSlot이 지정된 경우 결과에서 배포 슬롯 검색을 지원합니다. 이전 cmdlet 버전에서는 이 기능이 작동하지 않았습니다. 하지만 이제 문제가 해결되었습니다.

New-AzFunctionApp

이 옵션을 지정할 경우 application insights 프로젝트가 생성되지 않도록 New-AzFunctionApp의 -DisableApplicationInsights가 수정되었습니다.
PowerShell 6.2는 더 이상 지원되지 않으므로 PowerShell 6.2 함수 앱 생성을 지원하는 기능이 제거되었습니다. 고객을 위한 최신 지침은 PowerShell 7.0 함수 앱을 대신 만드는 것입니다.
RuntimeVersion 매개 변수가 지정되지 않은 경우 PowerShell 함수 앱에 대한 Windows의 Functions 버전 3 기본 런타임 버전이 6.2에서 7.0으로 변경되었습니다.
RuntimeVersion 매개 변수가 지정되지 않은 경우 Node 함수 앱에 대한 Windows 및 Linux의 Functions 버전 3 기본 런타임 버전이 10에서 12로 변경되었습니다. 그러나 사용자는 여전히 -Runtime Node 및 -RuntimeVersion 10을 지정하여 Node 10 함수 앱을 만들 수 있습니다. RuntimeVersion 매개 변수가 지정되지 않은 경우 Python 함수 앱에 대한 Linux의 Functions 버전 3 기본 런타임 버전이 3.7에서 3.8로 변경되었습니다. 그러나 사용자는 여전히 -Runtime Python 및 -RuntimeVersion 3.7을 지정하여 Python 3.7 함수 앱을 만들 수 있습니다.

# Create a Node 10 function app on Linux
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Linux `
                  -Runtime Node

# Create a Node 10 function app on Windows
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Windows `
                  -Runtime Node

# Create a Python 3.7 function app on Linux
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Linux `
                  -Runtime Python

이후

# Create a Node 10 function app on Linux
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Linux `
                  -Runtime Node `
                  -RuntimeVersion 10

# Create a Node 10 function app on Windows
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Windows `
                  -Runtime Node

# Create a Python 3.7 function app on Linux
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Linux `
                  -Runtime Python `
                  -RuntimeVersion 3.7

Az.KeyVault

New-AzKeyVault

DisableSoftDelete 매개 변수를 더 이상 지원하지 않으며 원래 매개 변수 이름의 별칭을 찾을 수 없습니다.

# Opt out soft delete while creating a key vault
New-AzKeyVault -VaultName 'Contoso03Vault' -ResourceGroupName 'Group14' -Location 'East US' -DisableSoftDelete

이후

일시 삭제 설정을 업데이트하는 기능은 Az.KeyVault 3.0.0에서 더 이상 사용되지 않습니다. 자세히 알아보기

Update-AzKeyVault

EnableSoftDelete, SoftDeleteRetentionInDays 매개 변수를 더 이상 지원하지 않으며 원래 매개 변수 이름의 별칭을 찾을 수 없습니다.

Update-AzKeyVault -VaultName 'Contoso03Vault' -ResourceGroupName 'Group14' -EnableSoftDelete -SoftDeleteRetentionInDays 15

이후

일시 삭제 설정을 업데이트하는 기능은 Az.KeyVault 3.0.0에서 더 이상 사용되지 않습니다. 자세히 알아보기

Get-AzKeyVaultSecret

Microsoft.Azure.Commands.KeyVault.Models.PSKeyVaultSecret 형식의 속성 SecretValueText가 제거되었습니다. 호출에 -AsPlainText를 적용하여 일반 텍스트 비밀을 가져오거나 스크립트에 SecureString 형식의 $secret.SecretValue를 사용합니다.

$secret = Get-AzKeyVaultSecret -VaultName myVault -Name mySecret
$secretInPlainText = $secret.SecretValueText

이후

$secretInPlainText = Get-AzKeyVaultSecret -VaultName myVault -Name mySecret -AsPlainText

Az.ManagedServices

Get-AzManagedServicesDefinition

ResourceId 매개 변수를 더 이상 지원하지 않으며 원래 매개 변수 이름의 별칭을 찾을 수 없습니다.

Get-AzManagedServicesDefinition -ResourceId xxx

이후

Get-AzManagedServicesDefinition -Id xxx

New-AzManagedServicesAssignment

RegistrationDefinitionName, RegistrationDefinitionResourceId 매개 변수를 더 이상 지원하지 않으며 원래 매개 변수 이름의 별칭을 찾을 수 없습니다.

New-AzManagedServicesAssignment -RegistrationDefinitionName xxx -Scope xxx

이후

New-AzManagedServicesAssignment -Scope xxx -RegistrationDefinition xxx

Remove-AzManagedServicesAssignment

Id, ResourceId 매개 변수를 더 이상 지원하지 않으며 원래 매개 변수 이름의 별칭을 찾을 수 없습니다.

Remove-AzManagedServicesAssignment -ResourceId xxx

이후

Get-AzManagedServicesAssignment -Scope xxx | Remove-AzManagedServicesAssignment

Remove-AzManagedServicesDefinition

Id, ResourceId 매개 변수를 더 이상 지원하지 않으며 원래 매개 변수 이름의 별칭을 찾을 수 없습니다.

Remove-AzManagedServicesDefinition -ResourceId xxx

이후

Get-AzManagedServicesDefinition -Scope xxx | Remove-AzManagedServicesDefinition

Az.ResourceManager

Get-AzManagementGroupDeployment

ApiVersion 매개 변수를 더 이상 지원하지 않으며 원래 매개 변수 이름의 별칭을 찾을 수 없습니다.

Get-AzManagementGroupDeployment -ManagementGroupId xxx -Name xxx -ApiVersion xxx