Руководство по переходу на Az версии 2.0.0

Статья
04/02/2024

Этот документ описывает изменения между Az версии 1.0.0 и Az версии 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.

Перед

Обратите внимание, что приведенный ниже код работает, но переданный параметр Name не используется, поэтому удаление этого параметра не влияет на функциональность.
```
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.

Перед

Обратите внимание, что приведенный ниже код работает, но переданный параметр Name не используется, поэтому удаление этого параметра не влияет на функциональность.
```
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.

Перед

Обратите внимание, что приведенный ниже код работает, но переданный параметр Name не используется, поэтому удаление этого параметра не влияет на функциональность.
```
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.

Перед

Обратите внимание, что приведенный ниже код работает, но переданный параметр Name не используется, поэтому удаление этого параметра не влияет на функциональность.
```
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.

Перед

Обратите внимание, что приведенный ниже код работает, но переданный параметр Name не используется, поэтому удаление этого параметра не влияет на функциональность.
```
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.

Перед

Обратите внимание, что приведенный ниже код работает, но переданный параметр Name не используется, поэтому удаление этого параметра не влияет на функциональность.
```
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.
Добавлен новый командлет 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

Пространства имен для типов, возвращаемых командлетами, выполняющими действия с большими двоичными объектами, очередями и файлами, были изменены с 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. Получение атрибутов файла или большого двоичного объекта с условием 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. В новой версии значением параметра Kind по умолчанию является StorageV2. Если вам нужно создать учетную запись хранения версии 1 с параметром Kind со значением Storage, добавьте параметр -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. Получение атрибутов файла или большого двоичного объекта с условием AccessCondition (изменение пространства имен объекта AccessCondition)

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

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