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

2025-08-14

Этот документ описывает изменения в версиях 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, Queue и File, были изменены с Microsoft.WindowsAzure.Storage на Microsoft.Azure.Storage. Хотя это не является технически критическим изменением в соответствии с политикой критических изменений, это может потребовать некоторых изменений в коде, который использует методы из .NET SDK для хранилищ для взаимодействия с объектами, возвращаемыми этими командлетами.

Пример 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. В предыдущих версиях при создании учетной записи хранения без указания параметра 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)

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

Обратная связь

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