Az 2.0.0 için Geçiş Kılavuzu

Bu belgede Az modülünün 1.0.0 ile 2.0.0 sürümleri arasındaki değişiklikler açıklanır

İçindekiler

Modüldeki yeni değişiklikler

Az.Compute

  • New-AzAvailabilitySet ve Update-AzAvailabilitySet cmdlet'lerinden Managed parametresi kaldırıldı, artık Sku = Aligned kullanılıyor

    Önce

    Update-AzAvailabilitySet -Managed
    

    Sonra

    Update-AzAvailabilitySet -Sku Aligned
    
  • Tutarlılık sağlamak için Update-AzImage cmdlet'inde 'ByName' ve 'ByResourceId' parametre kümelerinden Image parametresi kaldırıldı

    Önce

    Aşağıdaki kodun işlevsel olduğuna ama geçirilen ImageName değerinin kullanılmadığına dikkat edin. Dolayısıyla bu parametrenin kaldırılması işlevi etkilemez.

    Update-AzImage -ResourceGroupName $Rg -ImageName $Name -Image $Image -Tag $tags
    
    Update-AzImage -ResourceId $Id -Image $Image -Tag $tags
    

    Sonra

    Update-AzImage -ResourceGroupName $Rg -ImageName $Name -Tag $tags
    
    Update-AzImage -ResourceId $Id -Tag $tags
    
  • Tutarlılık sağlamak için Restart-AzVM cmdlet'inde 'ByObject' ve 'ByResourceId' parametre kümelerinden Name parametresi kaldırıldı

    Önce

    Aşağıdaki kodun işlevsel olduğuna ama geçirilen Name değerinin kullanılmadığına dikkat edin. Dolayısıyla bu parametrenin kaldırılması işlevi etkilemez.

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

    Sonra

    Restart-AzVM -InputObject $VM
    
    Restart-AzVM -ResourceId $Id
    
  • Tutarlılık sağlamak için Start-AzVM cmdlet'inde 'ByObject' ve 'ByResourceId' parametre kümelerinden Name parametresi kaldırıldı

    Önce

    Aşağıdaki kodun işlevsel olduğuna ama geçirilen Name değerinin kullanılmadığına dikkat edin. Dolayısıyla bu parametrenin kaldırılması işlevi etkilemez.

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

    Sonra

    Start-AzVM -InputObject $VM
    
    Start-AzVM -ResourceId $Id
    
  • Tutarlılık sağlamak için Stop-AzVM cmdlet'inde 'ByObject' ve 'ByResourceId' parametre kümelerinden Name parametresi kaldırıldı

    Önce

    Aşağıdaki kodun işlevsel olduğuna ama geçirilen Name değerinin kullanılmadığına dikkat edin. Dolayısıyla bu parametrenin kaldırılması işlevi etkilemez.

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

    Sonra

    Stop-AzVM -InputObject $VM
    
    Stop-AzVM -ResourceId $Id
    
  • Tutarlılık sağlamak için Remove-AzVM cmdlet'inde 'ByObject' ve 'ByResourceId' parametre kümelerinden Name parametresi kaldırıldı

    Önce

    Aşağıdaki kodun işlevsel olduğuna ama geçirilen Name değerinin kullanılmadığına dikkat edin. Dolayısıyla bu parametrenin kaldırılması işlevi etkilemez.

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

    Sonra

    Remove-AzVM -InputObject $VM
    
    Remove-AzVM -ResourceId $Id
    
  • Tutarlılık sağlamak için Set-AzVM cmdlet'inde 'ByObject' ve 'ByResourceId' parametre kümelerinden Name parametresi kaldırıldı

    Önce

    Aşağıdaki kodun işlevsel olduğuna ama geçirilen Name değerinin kullanılmadığına dikkat edin. Dolayısıyla bu parametrenin kaldırılması işlevi etkilemez.

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

    Sonra

    Set-AzVM -InputObject $VM ...
    
    Set-AzVM -ResourceId $Id ...
    
  • Tutarlılık sağlamak için Save-AzVMImage cmdlet'inde 'ByObject' ve 'ByResourceId' parametre kümelerinden Name parametresi kaldırıldı

    Önce

    Aşağıdaki kodun işlevsel olduğuna ama geçirilen Name değerinin kullanılmadığına dikkat edin. Dolayısıyla bu parametrenin kaldırılması işlevi etkilemez.

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

    Sonra

    Save-AzVMImage -InputObject $VM ...
    
    Save-AzVMImage -ResourceId $Id ...
    
  • PSVirtualMachineScaleSetVM içinde ProtectFromScaleIn özelliğini kapsüllemek için ProtectionPolicy özelliği eklendi

    Önce

    $vmss = Get-AzVMssVM ...
    $vmss.ProtectFromScaleIn = $true
    
    $vmss = Update-AzVMssVM ...
    $vmss.ProtectFromScaleIn = $true
    
    $vmss = Remove-AzVMssVMDataDisk ...
    $vmss.ProtectFromScaleIn = $true
    

    Sonra

    $vmss = Get-AzVMssVM ...
    $vmss.ProtectionPolicy.ProtectFromScaleIn = $true
    
    $vmss = Update-AzVMssVM ...
    $vmss.ProtectionPolicy.ProtectFromScaleIn = $true
    
    $vmss = Remove-AzVMssVMDataDisk ...
    $vmss.ProtectionPolicy.ProtectFromScaleIn = $true
    
    
  • EncryptionSettings özelliğini PSDisk içine almak için EncryptionSettingsCollection Özelliği eklendi

    Önce

    $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
    

    Sonra

    $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
    
  • EncryptionSettings özelliğini PSSnapshot içine almak için EncryptionSettingsCollection Özelliği eklendi

    Önce

    $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
    

    Sonra

    $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 içinden VirtualMachineProfile özelliği kaldırıldı

    Önce

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

    Sonra

    $vmss = New-AzVMSSConfig ...
    $vmss.AdditionalCapabilities.UltraSSDEnabled = $true
    
  • Set-AzVMBootDiagnostic cmdlet'inin Set-AzVMBootDiagnostics diğer adı kaldırıldı

    Önce

    Kullanım dışı bırakılan diğer ad kullanılıyor

    Set-AzVMBootDiagnostics
    

    Sonra

    Set-AzVMBootDIagnostic
    
  • Export-AzLogAnalyticThrottledRequest cmdlet'inin Export-AzLogAnalyticThrottledRequests diğer adı kaldırıldı

    Önce

    Kullanım dışı bırakılan diğer ad kullanılıyor

    Export-AzLogAnalyticThrottledRequests
    

    Sonra

    Export-AzLogAnalyticThrottledRequest
    

Az.HDInsight

  • Grant-AzHDInsightHttpServicesAccess ve Revoke-AzHDInsightHttpServicesAccess cmdlet'leri kaldırıldı. Tüm HDInsight kümelerinde HTTP erişimi her zaman etkin olduğundan artık bunlar gerekli değildir.
  • Yeni Set-AzHDInsightGatewayCredential cmdlet’i eklendi. Ağ geçidi HTTP kullanıcı adını ve parolasını değiştirmek için bu cmdlet'i kullanın (Grant-AzHDInsightHttpServicesAccess cmdlet'inin yerini aldı).
  • Get-AzHDInsightJobOutput cmdlet'i depolama anahtarına ayrıntılı rol tabanlı erişimi destekleyecek şekilde güncelleştirildi.
    • HDInsight Küme Operatörü, Katkıda Bulunan veya Sahip rolleri olan kullanıcılar etkilenmeyecek.
    • Yalnızca Okuyucu rolüne sahip kullanıcıların DefaultStorageAccountKey parametresini açık olarak belirtmesi gerekecek.

Bu rol tabanlı erişim değişiklikleri hakkında daha fazla bilgi için bkz. aka.ms/hdi-config-update

Önce

Grant-AzHDInsightHttpServicesAccess -ClusterName $cluster -HttpCredential $credential

Sonra

Set-AzHDInsightGatewayCredential -ClusterName $cluster -HttpCredential $credential

Get-AzHDInsightJobOutput cmdlet'i için yalnızca Okuyucu rolü olan kullanıcılar

Önce

Get-AzHDInsightJobOutput  -ClusterName $clusterName -JobId $jobId

Sonra

Get-AzHDInsightJobOutput  -ClusterName $clusterName -JobId $jobId -DefaultStorageAccountKey $storageAccountKey

Az.Storage

  • Blob, Kuyruk ve Dosya cmdlet'lerinden döndürülen türlerin Microsoft.WindowsAzure.Storage olan ad alanları Microsoft.Azure.Storage olarak değiştirildi. Bu hataya neden olan değişiklik ilkesine göre teknik açıdan hataya neden olan bir değişiklik olmasa da, bu cmdlet'lerden döndürülen nesnelerle etkileşim kurmak için Storage .Net SDK'sındaki yöntemleri kullanan kodlarda bazı değişiklikler yapmak gerekebilir.

    Örnek 1: Kuyruğa ileti ekleme (CloudQueueMessage nesne ad alanını değiştirme)

    Önce:

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

    Sonra:

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

    Örnek 2: AccessCondition ile Blob/Dosya Özniteliklerini Getirme (AccessCondition nesne ad alanını değiştirme)

    Önce:

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

    Sonra:

    $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)
    
  • Teknik olarak hataya neden olan bir değişiklik olmasa da, değişikliklerden döndürülen Depolama Hesaplarının Sku.Name özelliğinde New/Get/Set-AzStorageAccount aşağıdaki çıkış farklılıkları olduğunu fark edeceksiniz. (Değişiklik sonrasında, çıkış ve giriş SkuName adları uyumlu olur.)

    • "StandardLRS" -> "Standard_LRS";
    • "StandardGRS" -> "Standard_GRS";
    • "StandardRAGRS" -> "Standard_RAGRS";
    • "StandardZRS" -> "Standard_ZRS";
    • "PremiumLRS" -> "Premium_LRS";
  • Kind belirtmeden depolama hesabı oluştururken varsayılan hizmet davranışı değişti. Önceki sürümlerde Kind belirtilmeden bir depolama hesabı oluşturulduğunda Depolama hesabında Kind değeri olarak Storage kullanılıyordu; yeni sürümde varsayılan Kind değeri StorageV2 oldu. Kind değeri 'Storage' olan bir V1 Depolama hesabı oluşturmanız gerekiyorsa '-Kind Storage' parametresini ekleyin

    Örnek: Depolama Hesabı oluşturma (Varsayılan Tür değişikliği)

    Önce:

    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
    

    Sonra:

    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