Руководство по миграции на Az 5.0.0

В этом документе описаны отличия между версиями Az 4.0.0 и 5.0.0.

• Руководство по миграции на 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-AzManagedServicesAssignment
    • Remove-AzManagedServicesAssignment
    • 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
    • Remove-AzDeployment
    • Remove-AzTenantDeployment
    • 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
    • Save-AzResourceGroupDeploymentTemplate
    • Stop-AzResourceGroupDeployment
    • Test-AzResourceGroupDeployment
    • Get-AzManagementGroupDeploymentWhatIfResult
    • Get-AzTenantDeploymentWhatIfResult
  • Az.Sql
    • Set-AzSqlServerActiveDirectoryAdministrator
  • Az.Synapse
    • New-AzSynapseSqlPool
    • Update-AzSynapseSqlPool
  • Az.Network
    • Approve-AzPrivateEndpointConnection
    • Deny-AzPrivateEndpointConnection
    • Get-AzPrivateEndpointConnection
    • Remove-AzPrivateEndpointConnection
    • Set-AzPrivateEndpointConnection
    • New-AzNetworkWatcherConnectionMonitorEndpointObject

Az.Aks

New-AzAksCluster

• Больше не поддерживает параметр NodeOsType; для исходного имени параметра не найден псевдоним (всегда будет Linux).
• Больше не поддерживает псевдоним ClientIdAndSecret для параметра ServicePrincipalIdAndSecret.
• Значение по умолчанию 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

Больше не поддерживает псевдоним ClientIdAndSecret для параметра ServicePrincipalIdAndSecret.

Перед

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

Параметр-переключатель IncludeSlot был удален из всех наборов параметров Get-AzFunctionApp, кроме одного. Командлет теперь поддерживает получение слотов развертывания в результатах, если указать -IncludeSlot. Эта возможность была нарушена в предыдущей версии командлета, но сейчас она исправлена.

New-AzFunctionApp

• Исправлена проблема с -DisableApplicationInsights в New-AzFunctionApp, чтобы при указании этого параметра не создавался проект Application Insights.
• Отключена возможность создания приложений-функций PowerShell 6.2, так как для поддержка PowerShell 6.2 прекращена. Текущая рекомендация для клиентов — создавать приложения-функции PowerShell 7.0.
• Изменена версия среды выполнения по умолчанию (c версии 6.2 на 7.0) в Функциях версии 3 в Windows для приложений-функций PowerShell, если не указать параметр RuntimeVersion.
• Изменена версия среды выполнения по умолчанию в Функциях версии 3 в Windows и Linux для приложений-функций Node версий 10–12, если не указать параметр RuntimeVersion. При этом пользователи могут создавать приложения-функции Node 10, указывая -Runtime Node и -RuntimeVersion 10. Изменена версия среды выполнения по умолчанию (с версии 3.7 на 3.8) в Функциях версии 3 в Linux для приложений-функций Python, если не указать параметр 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

Больше не поддерживает параметры EnableSoftDelete и SoftDeleteRetentionInDays; для исходного имени параметра не найден псевдоним.

Перед

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

После

Возможность обновления параметра обратимого удаления является устаревшей в Az.KeyVault 3.0.0. Дополнительные сведения

Get-AzKeyVaultSecret

Свойство SecretValueText типа Microsoft.Azure.Commands.KeyVault.Models.PSKeyVaultSecret удалено. Примените -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

После

Get-AzManagementGroupDeployment -ManagementGroupId xxx -Name xxx

Get-AzManagementGroupDeploymentOperation

То же, что и Get-AzManagementGroupDeployment.

Get-AzDeployment

То же, что и Get-AzManagementGroupDeployment.

Get-AzDeploymentOperation

То же, что и Get-AzManagementGroupDeployment.

Get-AzDeploymentWhatIfResult

То же, что и Get-AzManagementGroupDeployment.

Get-AzTenantDeployment

То же, что и Get-AzManagementGroupDeployment.

Get-AzTenantDeploymentOperation

То же, что и Get-AzManagementGroupDeployment.

New-AzManagementGroupDeployment

То же, что и Get-AzManagementGroupDeployment.

New-AzDeployment

То же, что и Get-AzManagementGroupDeployment.

New-AzTenantDeployment

То же, что и Get-AzManagementGroupDeployment.

Remove-AzManagementGroupDeployment

То же, что и Get-AzManagementGroupDeployment.

Remove-AzDeployment

То же, что и Get-AzManagementGroupDeployment.

Remove-AzTenantDeployment

То же, что и Get-AzManagementGroupDeployment.

Save-AzManagementGroupDeploymentTemplate

То же, что и Get-AzManagementGroupDeployment.

Save-AzDeploymentTemplate

То же, что и Get-AzManagementGroupDeployment.

Save-AzTenantDeploymentTemplate

То же, что и Get-AzManagementGroupDeployment.

Stop-AzManagementGroupDeployment

То же, что и Get-AzManagementGroupDeployment.

Stop-AzDeployment

То же, что и Get-AzManagementGroupDeployment.

Stop-AzTenantDeployment

То же, что и Get-AzManagementGroupDeployment.

Test-AzManagementGroupDeployment

То же, что и Get-AzManagementGroupDeployment.

Test-AzDeployment

То же, что и Get-AzManagementGroupDeployment.

Test-AzTenantDeployment

То же, что и Get-AzManagementGroupDeployment.

Get-AzResourceGroupDeployment

То же, что и Get-AzManagementGroupDeployment.

Get-AzResourceGroupDeploymentOperation

То же, что и Get-AzManagementGroupDeployment.

Get-AzResourceGroupDeploymentWhatIfResult

То же, что и Get-AzManagementGroupDeployment.

New-AzResourceGroupDeployment

То же, что и Get-AzManagementGroupDeployment.

Remove-AzResourceGroupDeployment

То же, что и Get-AzManagementGroupDeployment.

Save-AzResourceGroupDeploymentTemplate

То же, что и Get-AzManagementGroupDeployment.

Stop-AzResourceGroupDeployment

То же, что и Get-AzManagementGroupDeployment.

Test-AzResourceGroupDeployment

То же, что и Get-AzManagementGroupDeployment.

Get-AzManagementGroupDeploymentWhatIfResult

То же, что и Get-AzManagementGroupDeployment.

Get-AzTenantDeploymentWhatIfResult

То же, что и Get-AzManagementGroupDeployment.

Az.Sql

Set-AzSqlServerActiveDirectoryAdministrator

Больше не поддерживает параметр IsAzureADOnlyAuthentication, и для исходного имени параметра не найден псевдоним.

Перед

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

После

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

Az.Synapse

New-AzSynapseSqlPool

Больше не поддерживает параметры FromBackup, FromRestorePoint, BackupResourceGroupName, BackupWorkspaceName, BackupSqlPoolName, BackupSqlPoolObject, BackupResourceId, SourceResourceGroupName, SourceWorkspaceName, SourceSqlPoolName, SourceSqlPoolObject, SourceResourceId и RestorePoint; для исходного имени параметра не найден псевдоним.

Перед

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

После

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

Update-AzSynapseSqlPool

Больше не поддерживает параметры Suspend и Resume; для исходного имени параметра не найден псевдоним.

Az.Network

Approve-AzPrivateEndpointConnection

Больше не поддерживает параметр PrivateLinkResourceType, и для исходного имени параметра не найден псевдоним.

Перед

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

После

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

Deny-AzPrivateEndpointConnection

То же, что и Approve-AzPrivateEndpointConnection.

Get-AzPrivateEndpointConnection

То же, что и Approve-AzPrivateEndpointConnection.

Remove-AzPrivateEndpointConnection

То же, что и Approve-AzPrivateEndpointConnection.

Set-AzPrivateEndpointConnection

То же, что и Approve-AzPrivateEndpointConnection.

New-AzNetworkWatcherConnectionMonitorEndpointObject

Больше не поддерживает параметры FilterType и FilterItem; для исходного имени параметра не найден псевдоним.

Перед

$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

После

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