Az 5.0.0 마이그레이션 가이드

아티클
05/03/2024

이 문서에서는 Az의 4.0.0 버전과 5.0.0 버전 간의 변경 내용을 설명합니다.

Az 5.0.0 마이그레이션 가이드

Az.Aks

New-AzAksCluster

더 이상 매개 변수를 지원하지 않으며 원래 매개 변수 NodeOsType 이름에 대한 별칭을 찾을 수 Linux없습니다.
ServicePrincipalIdAndSecret 매개 변수의 ClientIdAndSecret 별칭을 더 이상 지원하지 않습니다.
기본값 NodeVmSetType 은 .로 AvailabilitySetVirtualMachineScaleSets변경됩니다.
기본값 NetworkPlugin 은 .로 noneazure변경됩니다.

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

하나의 매개 변수 집합을 제외한 모든 매개 변수에서 switch 매개 변수가 Get-AzFunctionApp제거되었습니다IncludeSlot. 이제 cmdlet은 지정된 경우 -IncludeSlot 결과에서 배포 슬롯 검색을 지원합니다. 이 기능은 이전 cmdlet 버전에서 손상되었습니다. 그러나 이 문제는 이제 해결되었습니다.

New-AzFunctionApp

New-AzFunctionApp 이 옵션을 지정할 때 Application Insights 프로젝트가 만들어지지 않도록 수정 -DisableApplicationInsights 되었습니다.
PowerShell 6.2가 EOL이므로 PowerShell 6.2 함수 앱을 만드는 지원이 제거되었습니다. 고객을 위한 현재 지침은 대신 PowerShell 7.0 함수 앱을 만드는 것입니다.
매개 변수를 지정하지 않은 경우 PowerShell 함수 앱용 Windows의 Functions 버전 3에서 기본 런타임 버전을 6.2에서 7.0으로 RuntimeVersion 변경했습니다.
매개 변수가 지정되지 않은 경우 Windows 및 Linux for Node 함수 앱의 Functions 버전 3에서 기본 런타임 버전을 10에서 12로 RuntimeVersion 변경했습니다. 그러나 사용자는 노드 10 함수 앱을 지정하여 -Runtime Node 만들 수 있습니다 -RuntimeVersion 10. 매개 변수가 지정되지 않은 경우 Python 함수 앱용 Linux의 Functions 버전 3에서 기본 런타임 버전을 3.7에서 3.8로 RuntimeVersion 변경했습니다. 그러나 사용자는 Python 3.7 함수 앱을 지정하여 -Runtime Python 만들 수 있습니다 -RuntimeVersion 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

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

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

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

New-AzManagedServicesAssignment -RegistrationDefinitionName xxx -Scope xxx

이후

New-AzManagedServicesAssignment -Scope xxx -RegistrationDefinition xxx

Remove-AzManagedServicesAssignment

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

Remove-AzManagedServicesAssignment -ResourceId xxx

이후

Get-AzManagedServicesAssignment -Scope xxx | Remove-AzManagedServicesAssignment

Remove-AzManagedServicesDefinition

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

Remove-AzManagedServicesDefinition -ResourceId xxx

이후

Get-AzManagedServicesDefinition -Scope xxx | Remove-AzManagedServicesDefinition

Az.ResourceManager

Get-AzManagementGroupDeployment

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

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