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 ...
```

に ProtectFromScaleIn プロパティをカプセル化する ProtectionPolicy プロパティを追加しました 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コマンドレットを削除しました。すべての HDInsight クラスターで HTTP アクセスが常に有効になっているため、これらは不要になりました。
新しい 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 に変更されました。これは技術的には破壊的変更ポリシーに従った破壊的変更ではありませんが、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: AccessCondition を使用して BLOB/ファイル属性をフェッチする (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)

技術的には破壊的変更ではありませんが、 New/Get/Set-AzStorageAccount の変更から返されるストレージアカウントの Sku.Name プロパティの出力の違いは次のようになります。 (変更後、出力と入力 SkuName がアラインされます)。
- "StandardLRS" -> "Standard_LRS";
- "StandardGRS" -> "Standard_GRS";
- "StandardRAGRS" -> "Standard_RAGRS";
- "StandardZRS" -> "Standard_ZRS";
- "PremiumLRS" -> "Premium_LRS";

種類を指定してストレージアカウントを作成するときの既定のサービス動作が変更されました。以前のバージョンでは、Kindが指定されていないストレージアカウントが作成されると、ストレージアカウントの種類のStorageが使用されていましたが、新しいバージョンではStorageV2が既定のKind値となります。 Kind 'Storage' で V1 ストレージアカウントを作成する必要がある場合は、パラメーター '-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

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-08-05

Az 2.0.0 の移行ガイド

目次

モジュールの破壊的変更

Az.Compute

の前に

後の

の前に

後の

の前に

後の

の前に

後の

の前に

後の

の前に

後の

の前に

後の

の前に

後の

の前に

後の

の前に

後の

の前に

後の

の前に

後の

の前に

後の

の前に

後の

Az.HDInsight

の前に

後の

コマンドレット Get-AzHDInsightJobOutput の閲覧者ロールのみを持つユーザー

の前に

後の

Az.Storage

例 1: キューにメッセージを追加する (CloudQueueMessage オブジェクトの名前空間を変更する)

例 2: AccessCondition を使用して BLOB/ファイル属性をフェッチする (AccessCondition オブジェクト名前空間を変更する)

例: ストレージ アカウントを作成する (既定の種類の変更)

フィードバック

その他のリソース

例: ストレージアカウントを作成する (既定の種類の変更)