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

В этом документе описываются изменения между версиями 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-AzVMBootDiagnosticSet-AzVMBootDiagnostics

До

Использование устаревшего псевдонима
```
Set-AzVMBootDiagnostics
```
После
```
Set-AzVMBootDIagnostic
```
Удаленный псевдоним командлета Export-AzLogAnalyticThrottledRequestExport-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

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

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

Before:

$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)

After:

$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)

Before:

$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)

After:

$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"

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

Before:

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

After:

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

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

Была ли эта страница полезна?

Last updated on 2025-12-03

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

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

Оглавление

Критические изменения модуля

Az.Compute

До

После

До

После

До

После

До

После

До

После

До

После

До

После

До

После

До

После

До

После

До

После

До

После

До

После

До

После

Az.HDInsight

До

После

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

До

После

Az.Storage

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

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

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

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

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