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，因為其只適用於傳統容器登錄。

Az.Functions

Get-AzFunctionApp

已從 Get-AzFunctionApp 的所有參數集 (一個參數集除外) 中移除 IncludeSlot 切換參數。若已指定 -IncludeSlot，此 Cmdlet 現在支援在結果中擷取部署位置。這項功能在先前的 Cmdlet 版本中已中斷。不過，現在已修正此問題。

New-AzFunctionApp

已修正 New-AzFunctionApp 中的 -DisableApplicationInsights，若已指定此選項，就不會建立 Application Insights 專案。
已移除建立 PowerShell 6.2 函式應用程式的支援，因為 PowerShell 6.2 是 EOL。客戶目前的指引是改為建立 PowerShell 7.0 函式應用程式。
若未指定 RuntimeVersion 參數，Windows 上 Functions 第 3 版中 PowerShell 函式應用程式的預設執行階段版本已從 6.2 變更為 7.0。
若未指定 RuntimeVersion 參數，Windows 和 Linux 上 Functions 第 3 版中 Node 函式應用程式的預設執行階段版本已從 10 變更為 12。不過，使用者仍可藉由指定 -Runtime Node 和 -RuntimeVersion 10來建立 Node 10 函式應用程式。若未指定 RuntimeVersion 參數，Linux 上 Functions 第 3 版中 Python 函式應用程式的預設執行階段版本已從 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