你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
本文档介绍了 Az 版本 1.0.0 和 2.0.0 之间的变更。
目录
模块中断性变更
Az.Compute
从
Managed和New-AzAvailabilitySetcmdlet 中删除了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 = $trueCmdlet
Set-AzVMBootDiagnostic删除了Set-AzVMBootDiagnostics的别名之前
使用弃用的别名
Set-AzVMBootDiagnostics之后
Set-AzVMBootDIagnosticCmdlet
Export-AzLogAnalyticThrottledRequest删除了Export-AzLogAnalyticThrottledRequests的别名之前
使用弃用的别名
Export-AzLogAnalyticThrottledRequests之后
Export-AzLogAnalyticThrottledRequest
Az.HDInsight
- 删除了
Grant-AzHDInsightHttpServicesAccess和Revoke-AzHDInsightHttpServicesAccesscmdlet。 这些不再是必需的，因为 HTTP 访问权限在所有 HDInsight 群集上始终是启用的。 - 添加了一个新的
Set-AzHDInsightGatewayCredentialcmdlet。 使用此 cmdlet 更改网关 HTTP 用户名和密码（替换Grant-AzHDInsightHttpServicesAccess）。 - 更新了
Get-AzHDInsightJobOutputcmdlet，支持对存储密钥进行细化的基于角色的访问。- 具有 HDInsight 群集的“操作员”、“参与者”或“所有者”角色的用户将不受影响。
- 只具有“读者”角色的用户将需要显式指定
DefaultStorageAccountKey参数。
有关这些基于角色的访问权限更改的详细信息，请参阅 aka.ms/hdi-config-update
之前
Grant-AzHDInsightHttpServicesAccess -ClusterName $cluster -HttpCredential $credential
之后
Set-AzHDInsightGatewayCredential -ClusterName $cluster -HttpCredential $credential
只具有“读者”角色的用户（针对 cmdlet Get-AzHDInsightJobOutput）
之前
Get-AzHDInsightJobOutput -ClusterName $clusterName -JobId $jobId
之后
Get-AzHDInsightJobOutput -ClusterName $clusterName -JobId $jobId -DefaultStorageAccountKey $storageAccountKey
Az.Storage
从 Blob、Queue 和 File cmdlet 返回的类型的命名空间已从
Microsoft.WindowsAzure.Storage更改为Microsoft.Azure.Storage。 虽然根据中断性变更策略，这在技术上不算中断性变更，但在使用存储 .Net SDK 方法的代码中，可能需要进行一些更改，以便与这些 cmdlet 返回的对象进行交互。示例 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 的情况下创建存储帐户时的默认服务行为已更改。 在以前的版本中，创建存储帐户时如果没有指定
Kind，会使用Storage作为存储帐户类型；而在新版本中，StorageV2是默认Kind值。 如果需要创建类型为“Storage”的 V1 存储帐户，请添加参数“-Kind Storage”示例：创建存储帐户（默认 Kind 更改）
以前：
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
