Az 5.0.0 的移轉指南

發行項
03/05/2025

本文件說明 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 已被移除，因為它只適用於傳統 Container Registry。

Az.Functions

Get-AzFunctionApp

已將 IncludeSlot 切換參數從 Get-AzFunctionApp的所有參數集中移除，但保留在一個參數集中。 Cmdlet 現在支援在指定 -IncludeSlot 時擷取結果中的部署插槽。此功能在先前的 Cmdlet 版本中已中斷。不過，現在已修正此問題。

New-AzFunctionApp

已修正 New-AzFunctionApp 中的 -DisableApplicationInsights，確保在指定此選項時，不會建立任何 Application Insights 專案。
已移除建立 PowerShell 6.2 函式應用程式的支持，因為 PowerShell 6.2 是 EOL。客戶目前的指導方針是改為建立PowerShell 7.0函式應用程式。
未指定 RuntimeVersion 參數時，將 Windows 上 PowerShell 函式應用程式的 Functions 第 3 版的預設運行時間版本從 6.2 變更為 7.0。
未指定 RuntimeVersion 參數時，將 Windows 和 Linux 上 Node 函式應用程式的 Functions 第 3 版的預設運行時間版本從 10 變更為 12。不過，使用者仍然可以藉由指定 -Runtime Node 和 -RuntimeVersion 10來建立 Node 10 函式應用程式。未指定 RuntimeVersion 參數時，將 Linux 上適用於 Python 函式應用程式的 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