Руководство по миграции для Az 2.0.0

Статья
2025-04-08

В этом документе описываются изменения между версиями Az 1.0.0 и 2.0.0

Изменения, нарушающие совместимость модуля

Az.Compute

Удален параметр Managed из командлетов New-AzAvailabilitySet и Update-AzAvailabilitySet в пользу Sku = Aligned

Перед
```
Update-AzAvailabilitySet -Managed
```
После
```
Update-AzAvailabilitySet -Sku Aligned
```
Для согласованности удален параметр Image из наборов параметров ByName и ByResourceId в Update-AzImage

Перед

Обратите внимание, что приведенный ниже код работает, но переданное имя imageName не используется, поэтому удаление этого параметра не оказывает функционального влияния.
```
Update-AzImage -ResourceGroupName $Rg -ImageName $Name -Image $Image -Tag $tags

Update-AzImage -ResourceId $Id -Image $Image -Tag $tags
```
После
```
Update-AzImage -ResourceGroupName $Rg -ImageName $Name -Tag $tags

Update-AzImage -ResourceId $Id -Tag $tags
```
Для согласованности удален параметр Name из наборов параметров ByObject и ByResourceId в Restart-AzVM

Перед

Обратите внимание, что приведенный ниже код работает, но переданное имя не используется, поэтому удаление этого параметра не оказывает функционального влияния.
```
Restart-AzVM -InputObject $VM -Name $Name

Restart-AzVM -ResourceId $Id -Name $Name
```
После
```
Restart-AzVM -InputObject $VM

Restart-AzVM -ResourceId $Id
```
Для согласованности удален параметр Name из наборов параметров ByObject и ByResourceId в Start-AzVM

Перед

Обратите внимание, что приведенный ниже код работает, но переданное имя не используется, поэтому удаление этого параметра не оказывает функционального влияния.
```
Start-AzVM -InputObject $VM -Name $Name

Start-AzVM -ResourceId $Id -Name $Name
```
После
```
Start-AzVM -InputObject $VM

Start-AzVM -ResourceId $Id
```
Для согласованности удален параметр Name из наборов параметров ByObject и ByResourceId в Stop-AzVM

Перед

Обратите внимание, что приведенный ниже код работает, но переданное имя не используется, поэтому удаление этого параметра не оказывает функционального влияния.
```
Stop-AzVM -InputObject $VM -Name $Name

Stop-AzVM -ResourceId $Id -Name $Name
```
После
```
Stop-AzVM -InputObject $VM

Stop-AzVM -ResourceId $Id
```
Для согласованности удален параметр Name из наборов параметров ByObject и ByResourceId в Remove-AzVM

Перед

Обратите внимание, что приведенный ниже код работает, но переданное имя не используется, поэтому удаление этого параметра не оказывает функционального влияния.
```
Remove-AzVM -InputObject $VM -Name $Name

Remove-AzVM -ResourceId $Id -Name $Name
```
После
```
Remove-AzVM -InputObject $VM

Remove-AzVM -ResourceId $Id
```
Для согласованности удален параметр Name из наборов параметров ByObject и ByResourceId в Set-AzVM

Перед

Обратите внимание, что приведенный ниже код работает, но переданное имя не используется, поэтому удаление этого параметра не оказывает функционального влияния.
```
Set-AzVM -InputObject $VM -Name $Name ...

Set-AzVM -ResourceId $Id -Name $Name ...
```
После
```
Set-AzVM -InputObject $VM ...

Set-AzVM -ResourceId $Id ...
```
Для согласованности удален параметр Name из наборов параметров ByObject и ByResourceId в Save-AzVMImage

Перед

Обратите внимание, что приведенный ниже код работает, но переданное имя не используется, поэтому удаление этого параметра не оказывает функционального влияния.
```
Save-AzVMImage -InputObject $VM -Name $Name ...

Save-AzVMImage -ResourceId $Id -Name $Name ...
```
После
```
Save-AzVMImage -InputObject $VM ...

Save-AzVMImage -ResourceId $Id ...
```

Добавлено свойство ProtectionPolicy для инкапсуляции свойства ProtectFromScaleIn в PSVirtualMachineScaleSetVM

Перед

$vmss = Get-AzVMssVM ...
$vmss.ProtectFromScaleIn = $true

$vmss = Update-AzVMssVM ...
$vmss.ProtectFromScaleIn = $true

$vmss = Remove-AzVMssVMDataDisk ...
$vmss.ProtectFromScaleIn = $true

После

$vmss = Get-AzVMssVM ...
$vmss.ProtectionPolicy.ProtectFromScaleIn = $true

$vmss = Update-AzVMssVM ...
$vmss.ProtectionPolicy.ProtectFromScaleIn = $true

$vmss = Remove-AzVMssVMDataDisk ...
$vmss.ProtectionPolicy.ProtectFromScaleIn = $true

Добавлено свойство EncryptionSettingsCollection, чтобы заключить свойство EncryptionSettings в PSDisk

Перед

$disk = New-AzDisk ... | Set-AzDiskDiskEncrytionKey ...
$disk.EncryptionSettings

$disk = New-AzDisk ... | Set-AzDiskKeyEncrytionKey ...
$disk.EncryptionSettings

$update = New-AzDiskUpdateConfig | Set-AzDiskUpdateDiskEncryptionKey ...
$update.EncryptionSettings

$update = New-AzDiskUpdateConfig | Set-AzDiskUpdateKeyEncryptionKey ...
$update.EncryptionSettings

После

$disk = New-AzDisk ... | Set-AzDiskDiskEncrytionKey ...
$disk.EncryptionSettingsCollection.EncryptionSettings

$disk = New-AzDisk ... | Set-AzDiskKeyEncrytionKey ...
$disk.EncryptionSettingsCollection.EncryptionSettings

$update = New-AzDiskUpdateConfig | Set-AzDiskUpdateDiskEncryptionKey ...
$update.EncryptionSettingsCollection.EncryptionSettings

$update = New-AzDiskUpdateConfig | Set-AzDiskUpdateKeyEncryptionKey ...
$update.EncryptionSettingsCollection.EncryptionSettings

Добавлено свойство EncryptionSettingsCollection, чтобы заключить свойство EncryptionSettings в PSSnapshot

Перед

$snap = New-AzSnapshotConfig ... | Set-AzSnapshotDiskEncryptionKey ...
$snap.EncryptionSettings

$snap = New-AzSnapshotConfig ... | Set-AzSnapshotKeyEncryptionKey ...
$snap.EncryptionSettings

$update = New-AzSnapshotUpdateConfig ... | Set-AzSnapshotUpdateDiskEncryptionKey ...
$update.EncryptionSettings

$update = New-AzSnapshotUpdateConfig ... | Set-AzSnapshotUpdateKeyEncryptionKey ...
$update.EncryptionSettings

После

$snap = New-AzSnapshotConfig ... | Set-AzSnapshotDiskEncryptionKey ...
$snap.EncryptionSettingsCollection.EncryptionSettings

$snap = New-AzSnapshotConfig ... | Set-AzSnapshotKeyEncryptionKey ...
$snap.EncryptionSettingsCollection.EncryptionSettings

$update = New-AzSnapshotUpdateConfig ... | Set-AzSnapshotUpdateDiskEncryptionKey ...
$update.EncryptionSettingsCollection.EncryptionSettings

$update = New-AzSnapshotUpdateConfig ... | Set-AzSnapshotUpdateKeyEncryptionKey ...
$update.EncryptionSettingsCollection.EncryptionSettings

Удалено свойство VirtualMachineProfile из PSVirtualMachineScaleSet

Перед

$vmss = New-AzVMSSConfig ...
$vmss.VirtualMachineProfile.AdditionalCapabilities.UltraSSDEnabled = $true

После

$vmss = New-AzVMSSConfig ...
$vmss.AdditionalCapabilities.UltraSSDEnabled = $true

Командлет Set-AzVMBootDiagnostic удалил псевдоним для Set-AzVMBootDiagnostics

Перед

Использование устаревшего псевдонима
```
Set-AzVMBootDiagnostics
```
После
```
Set-AzVMBootDIagnostic
```
Командлет Export-AzLogAnalyticThrottledRequest удалил псевдоним для Export-AzLogAnalyticThrottledRequests

Перед

Использование устаревшего псевдонима
```
Export-AzLogAnalyticThrottledRequests
```
После
```
Export-AzLogAnalyticThrottledRequest
```

Az.HDInsight

Удалены командлеты Grant-AzHDInsightHttpServicesAccess и Revoke-AzHDInsightHttpServicesAccess. Они больше не нужны, так как доступ по HTTP всегда включен во всех кластерах HDInsight.
Добавлен новый cmdlet Set-AzHDInsightGatewayCredential. Используйте этот командлет для изменения имени пользователя и пароля HTTP шлюза (заменяет Grant-AzHDInsightHttpServicesAccess).
Обновлен командлет Get-AzHDInsightJobOutput для поддержки гранулярного доступа, основанного на ролях, к ключу хранилища.
- На пользователей с ролями оператора, участника или владельца кластера HDInsight это не повлияет.
- Только пользователям с ролью читателя нужно указывать параметр DefaultStorageAccountKey явным образом.

Дополнительные сведения об этих изменениях доступа на основе ролей можно найти по адресу aka.ms/hdi-config-update

Перед

Grant-AzHDInsightHttpServicesAccess -ClusterName $cluster -HttpCredential $credential

После

Set-AzHDInsightGatewayCredential -ClusterName $cluster -HttpCredential $credential

Пользователи с ролью читателя только для командлетов Get-AzHDInsightJobOutput

Перед

Get-AzHDInsightJobOutput  -ClusterName $clusterName -JobId $jobId

После

Get-AzHDInsightJobOutput  -ClusterName $clusterName -JobId $jobId -DefaultStorageAccountKey $storageAccountKey

Az.Storage

Пространства имен для типов, возвращаемых из командлетов объектов Blob, очередей и файлов, изменились с Microsoft.WindowsAzure.Storage на Microsoft.Azure.Storage. Хотя это не технически критическое изменение в соответствии с политикой критических изменений, это может потребовать некоторых изменений в коде, который использует методы из пакета SDK для хранилища .NET для взаимодействия с объектами, возвращаемыми из этих командлетов.

Пример 1. Добавление сообщения в очередь (изменение пространства имен объекта CloudQueueMessage)

До:

$queue = Get-AzStorageQueue –Name $queueName –Context $ctx
$queueMessage = New-Object -TypeName "Microsoft.WindowsAzure.Storage.Queue.CloudQueueMessage,$($queue.CloudQueue.GetType().Assembly.FullName)" -ArgumentList "This is message 1"
$queue.CloudQueue.AddMessageAsync($QueueMessage)

После:

$queue = Get-AzStorageQueue –Name $queueName –Context $ctx
$queueMessage = New-Object -TypeName "Microsoft.Azure.Storage.Queue.CloudQueueMessage,$($queue.CloudQueue.GetType().Assembly.FullName)"  -ArgumentList "This is message 1"
$queue.CloudQueue.AddMessageAsync($QueueMessage)

Пример 2. Получение атрибутов BLOB-файлов и файлов с AccessCondition (изменение пространства имен объекта AccessCondition)

До:

$accessCondition= New-Object Microsoft.WindowsAzure.Storage.AccessCondition

$blob = Get-AzureStorageBlob -Container $containerName -Blob $blobName
$blob.ICloudBlob.FetchAttributes($accessCondition)

$file = Get-AzureStorageFile -ShareName $shareName -Path $filepath
$file.FetchAttributes($accessCondition)

После:

$accessCondition= New-Object Microsoft.Azure.Storage.AccessCondition

$blob = Get-AzureStorageBlob -Container $containerName -Blob $blobName
$blob.ICloudBlob.FetchAttributes($accessCondition)

$file = Get-AzureStorageFile -ShareName $shareName -Path $filepath
$file.FetchAttributes($accessCondition)

Хотя это и не является технически значимым изменением, вы заметите различия в свойстве Sku.Name учетных записей хранения, исходящих из изменений New/Get/Set-AzStorageAccount, как показано ниже. (После изменения выходные данные и входные SkuName выровнены.)
- "StandardLRS" -> "Standard_LRS";
- "StandardGRS" —> "Standard_GRS";
- "StandardRAGRS" -> "Standard_RAGRS";
- "StandardZRS" -> "Standard_ZRS";
- "PremiumLRS" -> "Premium_LRS";

Поведение службы по умолчанию изменилось при создании учетной записи хранения без указания параметра типа. В предыдущих версиях при создании учетной записи хранения без Kind указан тип учетной записи хранения Storage, в новой версии StorageV2 используется значение по умолчанию Kind. Если необходимо создать учетную запись хранения версии 1 с типом "Хранилище", добавьте параметр "-Kind Storage"

Пример. Создание учетной записи хранения (изменение типа по умолчанию)

До:

PS c:\> New-AzStorageAccount -ResourceGroupName groupname -Name accountname -SkuName Standard_LRS -Location "westus"

StorageAccountName ResourceGroupName Location SkuName     Kind      AccessTier CreationTime          ProvisioningState EnableHttpsTrafficOnly
------------------ ----------------- -------- -------     ----      ---------- ------------          ----------------- ----------------------
accountname        groupname         westus   StandardLRS Storage   Hot        4/17/2018 10:34:32 AM Succeeded         False

После:

PS c:\> New-AzStorageAccount -ResourceGroupName groupname -Name accountname -SkuName Standard_LRS -Location "westus"

StorageAccountName ResourceGroupName Location SkuName      Kind      AccessTier CreationTime          ProvisioningState EnableHttpsTrafficOnly
------------------ ----------------- -------- -------      ----      ----------  ------------          ----------------- ----------------------
accountname        groupname         westus   Standard_LRS StorageV2 Hot        4/17/2018 10:34:32 AM Succeeded         False

Поделиться через

Руководство по миграции для Az 2.0.0

Оглавление

Изменения, нарушающие совместимость модуля

Az.Compute

Перед

После

Перед

После

Перед

После

Перед

После

Перед

После

Перед

После

Перед

После

Перед

После

Перед

После

Перед

После

Перед

После

Перед

После

Перед

После

Перед

После

Az.HDInsight

Перед

После

Пользователи с ролью читателя только для командлетов Get-AzHDInsightJobOutput

Перед

После

Az.Storage

Пример 1. Добавление сообщения в очередь (изменение пространства имен объекта CloudQueueMessage)

Пример 2. Получение атрибутов BLOB-файлов и файлов с AccessCondition (изменение пространства имен объекта AccessCondition)

Пример. Создание учетной записи хранения (изменение типа по умолчанию)

Дополнительные ресурсы