Az 2.0.0 的移轉指南
本文件說明 Az 1.0.0 和 2.0.0 版本之間的變更
目錄
模組重大變更
Az.Compute
已從
New-AzAvailabilitySet和Update-AzAvailabilitySetCmdlet 移除Managed參數，以利使用Sku = Aligned之前
Update-AzAvailabilitySet -Managed之後
Update-AzAvailabilitySet -Sku Aligned為了一致性，已從 'ByName' 和 'ByResourceId' 參數集中移除
Image參數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為了一致性，已從 'ByObject' 和 'ByResourceId' 參數集中移除
Name參數Restart-AzVM之前
請注意，下列程式代碼正常運作，但未使用傳入的 Name，因此移除此參數並不會影響功能。
Restart-AzVM -InputObject $VM -Name $Name Restart-AzVM -ResourceId $Id -Name $Name之後
Restart-AzVM -InputObject $VM Restart-AzVM -ResourceId $Id為了一致性，已從 'ByObject' 和 'ByResourceId' 參數集中移除
Name參數Start-AzVM之前
請注意，下列程式代碼正常運作，但未使用傳入的 Name，因此移除此參數並不會影響功能。
Start-AzVM -InputObject $VM -Name $Name Start-AzVM -ResourceId $Id -Name $Name之後
Start-AzVM -InputObject $VM Start-AzVM -ResourceId $Id為了一致性，已從 'ByObject' 和 'ByResourceId' 參數集中移除
Name參數Stop-AzVM之前
請注意，下列程式代碼正常運作，但未使用傳入的 Name，因此移除此參數並不會影響功能。
Stop-AzVM -InputObject $VM -Name $Name Stop-AzVM -ResourceId $Id -Name $Name之後
Stop-AzVM -InputObject $VM Stop-AzVM -ResourceId $Id為了一致性，已從 'ByObject' 和 'ByResourceId' 參數集中移除
Name參數Remove-AzVM之前
請注意，下列程式代碼正常運作，但未使用傳入的 Name，因此移除此參數並不會影響功能。
Remove-AzVM -InputObject $VM -Name $Name Remove-AzVM -ResourceId $Id -Name $Name之後
Remove-AzVM -InputObject $VM Remove-AzVM -ResourceId $Id為了一致性，已從 'ByObject' 和 'ByResourceId' 參數集中移除
Name參數Set-AzVM之前
請注意，下列程式代碼正常運作，但未使用傳入的 Name，因此移除此參數並不會影響功能。
Set-AzVM -InputObject $VM -Name $Name ... Set-AzVM -ResourceId $Id -Name $Name ...之後
Set-AzVM -InputObject $VM ... Set-AzVM -ResourceId $Id ...為了一致性，已從 'ByObject' 和 'ByResourceId' 參數集中移除
Name參數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 = $trueCmdlet
Set-AzVMBootDiagnostic已將別名移除至Set-AzVMBootDiagnostics之前
使用已被取代的別名
Set-AzVMBootDiagnostics之後
Set-AzVMBootDIagnosticCmdlet
Export-AzLogAnalyticThrottledRequest已將別名移除至Export-AzLogAnalyticThrottledRequests之前
使用已取代的別名
Export-AzLogAnalyticThrottledRequests之後
Export-AzLogAnalyticThrottledRequest
Az.HDInsight
Grant-AzHDInsightHttpServicesAccess已移除和Revoke-AzHDInsightHttpServicesAccessCmdlet。 因為所有 HDInsight 叢集上一律會啟用 HTTP 存取，因此不再需要這些存取。- 已新增 Cmdlet
Set-AzHDInsightGatewayCredential。 使用此 Cmdlet 來變更閘道 HTTP 使用者名稱和密碼（取代Grant-AzHDInsightHttpServicesAccess）。 - 更新 Cmdlet
Get-AzHDInsightJobOutput以支援對記憶體金鑰的細微角色型存取。- 具有 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”;
- “進階版 LRS” -> “進階版_LRS”;
建立指定 Kind 的記憶體帳戶時的預設服務行為已變更。 在舊版中，當記憶體帳戶建立時未
Kind指定，則會使用 儲存體 帳戶 KindStorage，在新版本StorageV2中是預設值Kind。 如果您需要使用 Kind '儲存體' 建立 V1 儲存體 帳戶，請新增參數 '-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
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應