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

Makale
11/07/2024

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

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 New/Get/Set-AzStorageAccount döndürülen Depolama Hesaplarının Sku.Name özelliğinde 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

Aracılığıyla paylaş

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

İçindekiler

Modüldeki yeni değişiklikler

Az.Compute

Önce

Sonra

Önce

Sonra

Önce

Sonra

Önce

Sonra

Önce

Sonra

Önce

Sonra

Önce

Sonra

Önce

Sonra

Önce

Sonra

Önce

Sonra

Önce

Sonra

Önce

Sonra

Önce

Sonra

Önce

Sonra

Az.HDInsight

Önce

Sonra

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

Önce

Sonra

Az.Storage

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

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

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

Ek kaynaklar