你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Az 2.0.0 迁移指南

本文档介绍 Az 1.0.0 和 2.0.0 版本之间的更改

目录

模块重大更改

Az.Compute

  • New-AzAvailabilitySetUpdate-AzAvailabilitySet cmdlet 中删除了 Managed 参数,改用 Sku = Aligned

    之前

    Update-AzAvailabilitySet -Managed
    

    之后

    Update-AzAvailabilitySet -Sku Aligned
    
  • 为了保持一致性,请从 Update-AzImage 中的“ByName”和“ByResourceId”参数集中删除 Image 参数

    之前

    请注意,下面的代码功能正常,但未使用传入的 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
    
  • 为了保持一致性,Restart-AzVM 中删除了“ByObject”和“ByResourceId”参数集中 Name 参数

    之前

    请注意,下面的代码功能正常,但未使用传入名称,因此删除此参数不会影响功能。

    Restart-AzVM -InputObject $VM -Name $Name
    
    Restart-AzVM -ResourceId $Id -Name $Name
    

    之后

    Restart-AzVM -InputObject $VM
    
    Restart-AzVM -ResourceId $Id
    
  • 为了保持一致性,Start-AzVM 中删除了“ByObject”和“ByResourceId”参数集中 Name 参数

    之前

    请注意,下面的代码功能正常,但未使用传入名称,因此删除此参数不会影响功能。

    Start-AzVM -InputObject $VM -Name $Name
    
    Start-AzVM -ResourceId $Id -Name $Name
    

    之后

    Start-AzVM -InputObject $VM
    
    Start-AzVM -ResourceId $Id
    
  • 为了保持一致性,Stop-AzVM 中删除了“ByObject”和“ByResourceId”参数集中 Name 参数

    之前

    请注意,下面的代码功能正常,但未使用传入名称,因此删除此参数不会影响功能。

    Stop-AzVM -InputObject $VM -Name $Name
    
    Stop-AzVM -ResourceId $Id -Name $Name
    

    之后

    Stop-AzVM -InputObject $VM
    
    Stop-AzVM -ResourceId $Id
    
  • 为了保持一致性,Remove-AzVM 中删除了“ByObject”和“ByResourceId”参数集中 Name 参数

    之前

    请注意,下面的代码功能正常,但未使用传入名称,因此删除此参数不会影响功能。

    Remove-AzVM -InputObject $VM -Name $Name
    
    Remove-AzVM -ResourceId $Id -Name $Name
    

    之后

    Remove-AzVM -InputObject $VM
    
    Remove-AzVM -ResourceId $Id
    
  • 为了保持一致性,Set-AzVM 中删除了“ByObject”和“ByResourceId”参数集中 Name 参数

    之前

    请注意,下面的代码功能正常,但未使用传入名称,因此删除此参数不会影响功能。

    Set-AzVM -InputObject $VM -Name $Name ...
    
    Set-AzVM -ResourceId $Id -Name $Name ...
    

    之后

    Set-AzVM -InputObject $VM ...
    
    Set-AzVM -ResourceId $Id ...
    
  • 为了保持一致性,Save-AzVMImage 中删除了“ByObject”和“ByResourceId”参数集中 Name 参数

    之前

    请注意,下面的代码功能正常,但未使用传入名称,因此删除此参数不会影响功能。

    Save-AzVMImage -InputObject $VM -Name $Name ...
    
    Save-AzVMImage -ResourceId $Id -Name $Name ...
    

    之后

    Save-AzVMImage -InputObject $VM ...
    
    Save-AzVMImage -ResourceId $Id ...
    
  • 添加了 ProtectionPolicy 属性,以便在 PSVirtualMachineScaleSetVM 中封装 ProtectFromScaleIn 属性

    之前

    $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
    
  • PSVirtualMachineScaleSet 中删除了 VirtualMachineProfile 属性

    之前

    $vmss = New-AzVMSSConfig ...
    $vmss.VirtualMachineProfile.AdditionalCapabilities.UltraSSDEnabled = $true
    

    之后

    $vmss = New-AzVMSSConfig ...
    $vmss.AdditionalCapabilities.UltraSSDEnabled = $true
    
  • Cmdlet Set-AzVMBootDiagnostic 删除了 Set-AzVMBootDiagnostics 的别名

    之前

    使用弃用的别名

    Set-AzVMBootDiagnostics
    

    之后

    Set-AzVMBootDIagnostic
    
  • Cmdlet Export-AzLogAnalyticThrottledRequest 删除了 Export-AzLogAnalyticThrottledRequests 的别名

    之前

    使用弃用的别名

    Export-AzLogAnalyticThrottledRequests
    

    之后

    Export-AzLogAnalyticThrottledRequest
    

Az.HDInsight

  • 删除了 Grant-AzHDInsightHttpServicesAccessRevoke-AzHDInsightHttpServicesAccess 命令行小程序。 不再需要这些操作,因为所有 HDInsight 群集始终启用了 HTTP 访问方式。
  • 添加了新的 Set-AzHDInsightGatewayCredential Cmdlet。 使用此 cmdlet 更改网关 HTTP 用户名和密码(替换 Grant-AzHDInsightHttpServicesAccess)。
  • 更新了 Get-AzHDInsightJobOutput cmdlet,以支持对存储密钥的基于角色的精细访问。
    • 具有 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、队列和文件 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