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 會從 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中移除 switch 參數。 Cmdlet 現在支援在指定時 -IncludeSlot 擷取結果中的部署位置。此功能在先前的 Cmdlet 版本中已中斷。不過，現在已修正此問題。

New-AzFunctionApp

已修正 -DisableApplicationInsights ， New-AzFunctionApp 如此一來，指定此選項時就不會建立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來建立節點 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 至呼叫以取得純文本密碼，或使用 $secret.SecretValue 腳本中的類型 SecureString 。

之前

$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