Panduan Migrasi untuk Az 5.0.0

Dokumen ini menjelaskan perubahan antara Az versi 4.0.0 dan 5.0.0.

• Panduan Migrasi untuk Az 5.0.0
  • Az.Aks
    • New-AzAksCluster
    • set-AzAksCluster
  • Az.ContainerRegistry
    • New-AzContainerRegistry
  • Az.Functions
    • Get-AzFunctionApp
    • New-AzFunctionApp
  • Az.KeyVault
    • New-AzKeyVault
    • Update-AzKeyVault
    • Get-AzKeyVaultSecret
  • Az.ManagedServices
    • Get-AzManagedServicesDefinition
    • New-PenugasanLayananTerkelolaAz
    • Hapus-PenugasanLayananTerkelolaAz
    • Remove-AzManagedServicesDefinition
  • Az.ResourceManager
    • Get-AzManagementGroupDeployment
    • Get-AzManagementGroupDeploymentOperation
    • Get-AzDeployment
    • Get-AzDeploymentOperation
    • Get-AzDeploymentWhatIfResult
    • Get-AzTenantDeployment
    • Get-AzTenantDeploymentOperation
    • New-AzManagementGroupDeployment
    • New-AzDeployment
    • New-AzTenantDeployment
    • Remove-AzManagementGroupDeployment
    • Hapus-AzDeployment
    • Hapus-PenerapanTenantAz
    • Save-AzManagementGroupDeploymentTemplate
    • Save-AzDeploymentTemplate
    • Save-AzTenantDeploymentTemplate
    • Stop-AzManagementGroupDeployment
    • Stop-AzDeployment
    • Stop-AzTenantDeployment
    • Test-AzManagementGroupDeployment
    • Test-AzDeployment
    • Test-AzTenantDeployment
    • Get-AzResourceGroupDeployment
    • Get-AzResourceGroupDeploymentOperation
    • Get-AzResourceGroupDeploymentWhatIfResult
    • New-AzResourceGroupDeployment
    • Remove-AzResourceGroupDeployment
    • Simpan-TemplatePenerapanGrupSumberAz
    • Stop-AzResourceGroupDeployment
    • Test-AzResourceGroupDeployment
    • Get-AzManagementGroupDeploymentWhatIfResult
    • Get-AzTenantDeploymentWhatIfResult
  • Az.Sql
    • Set-AzSqlServerActiveDirectoryAdministrator
  • Az.Synapse
    • new-AzSynapseSqlPool
    • Update-AzSynapseSqlPool
  • Az.Network
    • Menyetujui-AzPrivateEndpointConnection
    • Tolak-KoneksiEndpointPribadiAz
    • Get-AzPrivateEndpointConnection
    • Hapus-AzPrivateEndpointConnection
    • Set-AzPrivateEndpointConnection
    • New-AzNetworkWatcherConnectionMonitorEndpointObject

Az.Aks

New-AzAksCluster

• Tidak lagi mendukung parameter NodeOsType dan tidak ada alias yang ditemukan untuk nama parameter asli, itu akan selalu Linux.
• Tidak lagi mendukung alias ClientIdAndSecret untuk parameter ServicePrincipalIdAndSecret.
• Nilai default NodeVmSetType diubah dari AvailabilitySet menjadi VirtualMachineScaleSets.
• Nilai default NetworkPlugin diubah dari none menjadi azure.

Sebelum

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

Sesudah

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

Set-AzAksCluster

Tidak lagi mendukung alias ClientIdAndSecret untuk parameter ServicePrincipalIdAndSecret.

Sebelum

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

Sesudah

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

Az.ContainerRegistry

New-AzContainerRegistry

Tidak lagi mendukung parameter StorageAccountName dan tidak ada alias yang ditemukan untuk nama parameter asli.

Sebelum

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

Sesudah

Classic tidak digunakan lagi dan StorageAccountName dihapus karena hanya berfungsi dengan Container Registry Klasik.

Az.Functions

Get-AzFunctionApp

Menghapus parameter sakelar IncludeSlot dari semua kecuali satu set parameter Get-AzFunctionApp. Cmdlet kini memungkinkan pengambilan slot penyebaran dalam output ketika -IncludeSlot ditentukan. Fungsionalitas ini rusak dalam versi cmdlet sebelumnya. Namun, ini sekarang diperbaiki.

New-AzFunctionApp

• Memperbaiki -DisableApplicationInsights dalam New-AzFunctionApp sehingga tidak ada proyek application insights yang dibuat saat opsi ini ditentukan.
• Menghapus dukungan untuk membuat aplikasi fungsi PowerShell 6.2 karena PowerShell 6.2 sudah mencapai Akhir Masa Pakai (EOL). Panduan saat ini untuk pelanggan adalah membuat aplikasi fungsi PowerShell 7.0 sebagai gantinya.
• Mengubah versi runtime default di Functions versi 3 di Windows untuk aplikasi fungsi PowerShell dari 6.2 menjadi 7.0 saat parameter RuntimeVersion tidak ditentukan.
• Mengubah versi runtime default di Functions versi 3 di Windows dan Linux untuk aplikasi fungsi Node dari 10 menjadi 12 saat parameter RuntimeVersion tidak ditentukan. Namun, pengguna masih dapat membuat aplikasi fungsi Node 10 dengan menentukan -Runtime Node dan -RuntimeVersion 10. Mengubah versi runtime default di Functions versi 3 di Linux untuk aplikasi fungsi Python dari 3.7 menjadi 3.8 saat parameter RuntimeVersion tidak ditentukan. Namun, pengguna masih dapat membuat aplikasi fungsi Python 3.7 dengan menentukan -Runtime Python dan -RuntimeVersion 3.7.

Sebelum

# 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

Sesudah

# 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

Tidak lagi mendukung parameter DisableSoftDelete dan tidak ada alias yang ditemukan untuk nama parameter asli.

Sebelum

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

Sesudah

Kemampuan untuk memperbarui pengaturan penghapusan sementara tidak digunakan lagi di Az.KeyVault 3.0.0. Baca selengkapnya

Update-AzKeyVault

Tidak lagi mendukung parameter EnableSoftDelete, SoftDeleteRetentionInDays, dan tidak ada alias yang ditemukan untuk nama parameter asli.

Sebelum

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

Sesudah

Kemampuan untuk memperbarui pengaturan penghapusan sementara tidak digunakan lagi di Az.KeyVault 3.0.0. Baca selengkapnya

Get-AzKeyVaultSecret

Properti SecretValueText tipe Microsoft.Azure.Commands.KeyVault.Models.PSKeyVaultSecret telah dihapus. Terapkan -AsPlainText ke panggilan untuk mendapatkan rahasia teks biasa, atau gunakan $secret.SecretValue jenis SecureString dalam skrip Anda.

Sebelum

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

Sesudah

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

Az.ManagedServices

Get-AzManagedServicesDefinition

Tidak lagi mendukung parameter ResourceId dan tidak ada alias yang ditemukan untuk nama parameter asli.

Sebelum

Get-AzManagedServicesDefinition -ResourceId xxx

Sesudah

Get-AzManagedServicesDefinition -Id xxx

New-AzManagedServicesAssignment

Tidak lagi mendukung parameter RegistrationDefinitionName, RegistrationDefinitionResourceId, dan tidak ada alias yang ditemukan untuk nama parameter asli.

Sebelum

New-AzManagedServicesAssignment -RegistrationDefinitionName xxx -Scope xxx

Sesudah

New-AzManagedServicesAssignment -Scope xxx -RegistrationDefinition xxx

Remove-AzManagedServicesAssignment

Tidak lagi mendukung parameter Id, ResourceId, dan tidak ada alias yang ditemukan untuk nama parameter asli.

Sebelum

Remove-AzManagedServicesAssignment -ResourceId xxx

Sesudah

Get-AzManagedServicesAssignment -Scope xxx | Remove-AzManagedServicesAssignment

Remove-AzManagedServicesDefinition

Tidak lagi mendukung parameter Id, ResourceId, dan tidak ada alias yang ditemukan untuk nama parameter asli.

Sebelum

Remove-AzManagedServicesDefinition -ResourceId xxx

Sesudah

Get-AzManagedServicesDefinition -Scope xxx | Remove-AzManagedServicesDefinition

Az.ResourceManager

Get-AzManagementGroupDeployment

Tidak lagi mendukung parameter ApiVersion dan tidak ada alias yang ditemukan untuk nama parameter asli.

Sebelum

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

Sesudah

Get-AzManagementGroupDeployment -ManagementGroupId xxx -Name xxx

Get-AzManagementGroupDeploymentOperation

Sama dengan Get-AzManagementGroupDeployment.

Get-AzDeployment

Sama dengan Get-AzManagementGroupDeployment.

Get-AzDeploymentOperation

Sama dengan Get-AzManagementGroupDeployment.

Get-AzDeploymentWhatIfResult

Sama dengan Get-AzManagementGroupDeployment.

Get-AzTenantDeployment

Sama dengan Get-AzManagementGroupDeployment.

Get-AzTenantDeploymentOperation

Sama dengan Get-AzManagementGroupDeployment.

New-AzManagementGroupDeployment

Sama dengan Get-AzManagementGroupDeployment.

New-AzDeployment

Sama dengan Get-AzManagementGroupDeployment.

New-AzTenantDeployment

Sama dengan Get-AzManagementGroupDeployment.

Remove-AzManagementGroupDeployment

Sama dengan Get-AzManagementGroupDeployment.

Remove-AzDeployment

Sama dengan Get-AzManagementGroupDeployment.

Remove-AzTenantDeployment

Sama dengan Get-AzManagementGroupDeployment.

Save-AzManagementGroupDeploymentTemplate

Sama dengan Get-AzManagementGroupDeployment.

Save-AzDeploymentTemplate

Sama dengan Get-AzManagementGroupDeployment.

Save-AzTenantDeploymentTemplate

Sama dengan Get-AzManagementGroupDeployment.

Stop-AzManagementGroupDeployment

Sama dengan Get-AzManagementGroupDeployment.

Stop-AzDeployment

Sama dengan Get-AzManagementGroupDeployment.

Stop-AzTenantDeployment

Sama dengan Get-AzManagementGroupDeployment.

Test-AzManagementGroupDeployment

Sama dengan Get-AzManagementGroupDeployment.

Test-AzDeployment

Sama dengan Get-AzManagementGroupDeployment.

Test-AzTenantDeployment

Sama dengan Get-AzManagementGroupDeployment.

Get-AzResourceGroupDeployment

Sama dengan Get-AzManagementGroupDeployment.

Get-AzResourceGroupDeploymentOperation

Sama dengan Get-AzManagementGroupDeployment.

Get-AzResourceGroupDeploymentWhatIfResult

Sama dengan Get-AzManagementGroupDeployment.

New-AzResourceGroupDeployment

Sama dengan Get-AzManagementGroupDeployment.

Remove-AzResourceGroupDeployment

Sama dengan Get-AzManagementGroupDeployment.

Save-AzResourceGroupDeploymentTemplate

Sama dengan Get-AzManagementGroupDeployment.

Stop-AzResourceGroupDeployment

Sama dengan Get-AzManagementGroupDeployment.

Test-AzResourceGroupDeployment

Sama dengan Get-AzManagementGroupDeployment.

Get-AzManagementGroupDeploymentWhatIfResult

Sama dengan Get-AzManagementGroupDeployment.

Get-AzTenantDeploymentWhatIfResult

Sama dengan Get-AzManagementGroupDeployment.

Az.Sql

Set-AzSqlServerActiveDirectoryAdministrator

Tidak lagi mendukung parameter IsAzureADOnlyAuthentication dan tidak ada alias yang ditemukan untuk nama parameter asli.

Sebelum

Set-AzSqlServerActiveDirectoryAdministrator -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01' -DisplayName 'DBAs' -IsAzureADOnlyAuthentication

Sesudah

Set-AzSqlServerActiveDirectoryAdministrator -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01' -DisplayName 'DBAs'

Az.Synapse

New-AzSynapseSqlPool

Tidak lagi mendukung parameter FromBackup, FromRestorePoint, BackupResourceGroupName, BackupWorkspaceName, BackupSqlPoolName, BackupSqlPoolObject, BackupResourceId, SourceResourceGroupName, SourceWorkspaceName, SourceSqlPoolName, SourceSqlPoolObject, SourceResourceId, RestorePoint, dan tidak ada alias yang ditemukan untuk nama parameter asli.

Sebelum

New-AzSynapseSqlPool -FromBackup -WorkspaceName ContosoWorkspace -Name ContosoSqlPool -BackupWorkspaceName ContosoWorkspace -BackupSqlPoolName ExistingContosoSqlPool

Sesudah

PS C:\> New-AzSynapseSqlPool -WorkspaceName ContosoWorkspace -Name ContosoSqlPool -PerformanceLevel DW200c

Update-AzSynapseSqlPool

Tidak lagi mendukung parameter Suspend, Resume, dan tidak ada alias yang ditemukan untuk nama parameter asli.

Az.Network

Approve-AzPrivateEndpointConnection

Tidak lagi mendukung parameter PrivateLinkResourceType dan tidak ada alias yang ditemukan untuk nama parameter asli.

Sebelum

Approve-AzPrivateEndpointConnection -ResourceGroupName xxx -ServiceName xxx -Name xxx -PrivateLinkResourceType 'Microsoft.Network/privateLinkServices' -Description xxx

Sesudah

Approve-AzPrivateEndpointConnection -ResourceGroupName xxx -ServiceName xxx -Name xxx -Description xxx

Deny-AzPrivateEndpointConnection

Sama dengan Approve-AzPrivateEndpointConnection.

Get-AzPrivateEndpointConnection

Sama dengan Approve-AzPrivateEndpointConnection.

Remove-AzPrivateEndpointConnection

Sama dengan Approve-AzPrivateEndpointConnection.

Set-AzPrivateEndpointConnection

Sama dengan Approve-AzPrivateEndpointConnection.

New-AzNetworkWatcherConnectionMonitorEndpointObject

Tidak lagi mendukung parameter FilterType, FilterItem, dan tidak ada alias yang ditemukan untuk nama parameter asli.

Sebelum

$MySrcResourceId1 = '/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myresourceGroup/providers/Microsoft.OperationalInsights/workspaces/myworkspace'
$SrcEndpointFilterItem1 =New-AzNetworkWatcherConnectionMonitorEndpointFilterItemObject -Type 'AgentAddress' -Address 'WIN-P0HGNDO2S1B'
$SourceEndpointObject1 = New-AzNetworkWatcherConnectionMonitorEndPointObject -Name 'workspaceEndpoint' -ResourceId $MySrcResourceId1 -FilterType Include -FilterItem $SrcEndpointFilterItem1

Sesudah

MySrcResourceId1 = '/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myresourceGroup/providers/Microsoft.OperationalInsights/workspaces/myworkspace'
$SourceEndpointObject1 = New-AzNetworkWatcherConnectionMonitorEndPointObject -Name 'workspaceEndpoint' -ResourceId $MySrcResourceId1