Freigeben über

Migrationshandbuch für Az 2.0.0

In diesem Dokument werden die Änderungen zwischen den Versionen 1.0.0 und 2.0.0.0 von Az beschrieben.

Inhaltsverzeichnis

Modulbruchänderungen

Az.Compute

  • Managed Parameter entfernt aus New-AzAvailabilitySet und Update-AzAvailabilitySet Cmdlets zugunsten der VerwendungSku = Aligned

    Vorher

    Update-AzAvailabilitySet -Managed

    Nach

    Update-AzAvailabilitySet -Sku Aligned

  • Aus Konsistenzgründen entfernter Image Parameter aus den Parametersätzen 'ByName' und 'ByResourceId' in Update-AzImage

    Vorher

    Beachten Sie, dass der folgende Code funktionsfähig ist, aber der übergebene ImageName nicht verwendet wird, sodass das Entfernen dieses Parameters keine funktionale Auswirkung hat.

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

Update-AzImage -ResourceId $Id -Image $Image -Tag $tags

    Nach

    Update-AzImage -ResourceGroupName $Rg -ImageName $Name -Tag $tags

Update-AzImage -ResourceId $Id -Tag $tags

  • Aus Konsistenzgründen entfernter Name Parameter aus den Parametersätzen "ByObject" und "ByResourceId" in Restart-AzVM

    Vorher

    Beachten Sie, dass der folgende Code funktionsfähig ist, aber der übergebene Name nicht verwendet wird, sodass das Entfernen dieses Parameters keine funktionale Auswirkung hat.

    Restart-AzVM -InputObject $VM -Name $Name

Restart-AzVM -ResourceId $Id -Name $Name

    Nach

    Restart-AzVM -InputObject $VM

Restart-AzVM -ResourceId $Id

  • Aus Konsistenzgründen entfernter Name Parameter aus den Parametersätzen "ByObject" und "ByResourceId" in Start-AzVM

    Vorher

    Beachten Sie, dass der folgende Code funktionsfähig ist, aber der übergebene Name nicht verwendet wird, sodass das Entfernen dieses Parameters keine funktionale Auswirkung hat.

    Start-AzVM -InputObject $VM -Name $Name

Start-AzVM -ResourceId $Id -Name $Name

    Nach

    Start-AzVM -InputObject $VM

Start-AzVM -ResourceId $Id

  • Aus Konsistenzgründen entfernter Name Parameter aus den Parametersätzen "ByObject" und "ByResourceId" in Stop-AzVM

    Vorher

    Beachten Sie, dass der folgende Code funktionsfähig ist, aber der übergebene Name nicht verwendet wird, sodass das Entfernen dieses Parameters keine funktionale Auswirkung hat.

    Stop-AzVM -InputObject $VM -Name $Name

Stop-AzVM -ResourceId $Id -Name $Name

    Nach

    Stop-AzVM -InputObject $VM

Stop-AzVM -ResourceId $Id

  • Aus Konsistenzgründen entfernter Name Parameter aus den Parametersätzen "ByObject" und "ByResourceId" in Remove-AzVM

    Vorher

    Beachten Sie, dass der folgende Code funktionsfähig ist, aber der übergebene Name nicht verwendet wird, sodass das Entfernen dieses Parameters keine funktionale Auswirkung hat.

    Remove-AzVM -InputObject $VM -Name $Name

Remove-AzVM -ResourceId $Id -Name $Name

    Nach

    Remove-AzVM -InputObject $VM

Remove-AzVM -ResourceId $Id

  • Aus Konsistenzgründen entfernter Name Parameter aus den Parametersätzen "ByObject" und "ByResourceId" in Set-AzVM

    Vorher

    Beachten Sie, dass der folgende Code funktionsfähig ist, aber der übergebene Name nicht verwendet wird, sodass das Entfernen dieses Parameters keine funktionale Auswirkung hat.

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

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

    Nach

    Set-AzVM -InputObject $VM ...

Set-AzVM -ResourceId $Id ...

  • Aus Konsistenzgründen entfernter Name Parameter aus den Parametersätzen "ByObject" und "ByResourceId" in Save-AzVMImage

    Vorher

    Beachten Sie, dass der folgende Code funktionsfähig ist, aber der übergebene Name nicht verwendet wird, sodass das Entfernen dieses Parameters keine funktionale Auswirkung hat.

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

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

    Nach

    Save-AzVMImage -InputObject $VM ...

Save-AzVMImage -ResourceId $Id ...

  • Die ProtectionPolicy-Eigenschaft wurde zur Kapselung ProtectFromScaleIn der Eigenschaft in PSVirtualMachineScaleSetVM

    Vorher

    $vmss = Get-AzVMssVM ...
$vmss.ProtectFromScaleIn = $true

$vmss = Update-AzVMssVM ...
$vmss.ProtectFromScaleIn = $true

$vmss = Remove-AzVMssVMDataDisk ...
$vmss.ProtectFromScaleIn = $true

    Nach

    $vmss = Get-AzVMssVM ...
$vmss.ProtectionPolicy.ProtectFromScaleIn = $true

$vmss = Update-AzVMssVM ...
$vmss.ProtectionPolicy.ProtectFromScaleIn = $true

$vmss = Remove-AzVMssVMDataDisk ...
$vmss.ProtectionPolicy.ProtectFromScaleIn = $true

  • Eigenschaft EncryptionSettingsCollection hinzugefügt, um die Eigenschaft einzuschließen EncryptionSettings in PSDisk

    Vorher

    $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

    Nach

    $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

  • Eigenschaft EncryptionSettingsCollection hinzugefügt, um die Eigenschaft einzuschließen EncryptionSettings in PSSnapshot

    Vorher

    $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

    Nach

    $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 Eigenschaft entfernt ausPSVirtualMachineScaleSet

    Vorher

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

    Nach

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

  • Cmdlet Set-AzVMBootDiagnostic entfernten Alias zu Set-AzVMBootDiagnostics

    Vorher

    Verwenden veralteter Aliase

    Set-AzVMBootDiagnostics

    Nach

    Set-AzVMBootDIagnostic

  • Cmdlet Export-AzLogAnalyticThrottledRequest entfernten Alias zu Export-AzLogAnalyticThrottledRequests

    Vorher

    Verwenden veralteter Aliase

    Export-AzLogAnalyticThrottledRequests

    Nach

    Export-AzLogAnalyticThrottledRequest

Az.HDInsight

  • Die Und Grant-AzHDInsightHttpServicesAccess Cmdlets wurden entferntRevoke-AzHDInsightHttpServicesAccess. Diese sind nicht mehr erforderlich, da der HTTP-Zugriff immer in allen HDInsight-Clustern aktiviert ist.
  • Ein neues Set-AzHDInsightGatewayCredential Cmdlet wurde hinzugefügt. Verwenden Sie dieses Cmdlet, um den HTTP-Benutzernamen und das Kennwort des Gateways zu ändern (ersetzt Grant-AzHDInsightHttpServicesAccess).
  • Get-AzHDInsightJobOutput Das Cmdlet wurde aktualisiert, um den differenzierten rollenbasierten Zugriff auf den Speicherschlüssel zu unterstützen.
    • Benutzer mit HDInsight-Clusteroperator-, Mitwirkenden- oder Besitzerrollen sind nicht betroffen.
    • Benutzer mit nur der Rolle "Leser" müssen den Parameter explizit angeben DefaultStorageAccountKey .

Weitere Informationen zu diesen rollenbasierten Zugriffsänderungen finden Sie unter aka.ms/hdi-config-update

Vorher

Grant-AzHDInsightHttpServicesAccess -ClusterName $cluster -HttpCredential $credential

Nach

Set-AzHDInsightGatewayCredential -ClusterName $cluster -HttpCredential $credential

Benutzer mit nur leseberechtigter Rolle für Cmdlet-Get-AzHDInsightJobOutput

Vorher

Get-AzHDInsightJobOutput  -ClusterName $clusterName -JobId $jobId

Nach

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

Az.Storage

  • Namespaces für Typen, die von Blob-, Warteschlangen- und Datei-Cmdlets zurückgegeben werden, haben ihren Namespace von Microsoft.WindowsAzure.Storage zu Microsoft.Azure.Storage" geändert. Dies ist zwar technisch keine bahnbrechende Änderung gemäß der richtlinienumbruchweisen Änderung, erfordert jedoch möglicherweise einige Änderungen im Code, der die Methoden aus dem Storage .Net SDK verwendet, um mit den objekten zu interagieren, die von diesen Cmdlets zurückgegeben werden.

    Beispiel 1: Hinzufügen einer Nachricht zu einer Warteschlange (Ändern des CloudQueueMessage-Objektnamespaces)

    Before:

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

    Danach:

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

    Beispiel 2: Abrufen von Blob-/Dateiattributen mit AccessCondition (Ändern des AccessCondition-Objektnamespaces)

    Before:

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

    Danach:

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

  • Obwohl es sich nicht technisch um eine bahnbrechende Änderung handelt, werden Sie feststellen, dass die Ausgabeunterschiede in der Sku.Name Eigenschaft von Speicherkonten, die von New/Get/Set-AzStorageAccount Änderungen zurückgegeben werden, wie folgt aussehen. (Nach der Änderung werden Ausgabe- und Eingabe-SkuName ausgerichtet.)

    • "StandardLRS" -> "Standard_LRS";
    • "StandardGRS" -> "Standard_GRS";
    • "StandardRAGRS" -> "Standard_RAGRS";
    • "StandardZRS" -> "Standard_ZRS";
    • "PremiumLRS" -> "Premium_LRS";

  • Das Standarddienstverhalten beim Erstellen eines Speicherkontos, bei dem angegeben wird, dass eine Art geändert wurde. In früheren Versionen, wenn ein Speicherkonto ohne Kind Angabe erstellt wurde, wurde die Speicherkontoart verwendet Storage , in der neuen Version StorageV2 ist der Standardwert Kind . Wenn Sie ein V1-Speicherkonto mit dem Typ "Storage" erstellen müssen, fügen Sie den Parameter "-Kind Storage" hinzu.

    Beispiel: Erstellen eines Speicherkontos (Standardtypänderung)

    Before:

    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

    Danach:

    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
  • Last updated on