Az 1.0.0 için son değişiklikler

  • Makale
  • Okumak için 7 dakika

Bu belgede, AzureRM 6.x ile yeni Az modülü sürüm 1.x ve sonraki sürümler arasındaki değişiklikler hakkında ayrıntılı bilgi sağlar. İçindekiler tablosu, betiklerinizi etkileyebilecek modüle özgü değişiklikler de içinde olmak üzere, tam geçiş yolu boyunca size yol gösterir.

AzureRM'den Az'e geçişle ilgili genel öneriler için bkz. AzureRM'den Az'e geçişi başlatma.

Önemli

Az 1.0.0 ve Az 2.0.0 arasında da son değişiklikler oldu. AzureRM'den Az'e güncellemek için bu kılavuzu takip ettikten sonra, ek değişiklik yapma gerektir mi diye görmek için Az 2.0.0 değişikliklerine bakın.

İçindekiler Tablosu

Genel en son değişiklikler

Bu bölümde, Az modülünün yeniden tasarımında yer alan genel en son değişiklikler ayrıntılarıyla yer almaktadır.

Cmdlet Ad Öneki Değişiklikleri

AzureRM modülünde, cmdlet'ler ad AzureRM ön eki olarak veya bir ad ön eki olarak Azure kullanılır. Az, cmdlet adlarını basitleştirerek ve normalleştirerek tüm cmdlet'lerin cmdlet isim ön eki olarak "Az" kullanmasını sağlar. Örneğin:

Get-AzureRMVM
Get-AzureKeyVaultSecret

Şu şekilde değişti:

Get-AzVM
Get-AzKeyVaultSecret

Bu yeni cmdlet adlara geçişi basit hale getirmek için Az tarafından iki yeni cmdlet vardır: Enable-AzureRmAlias ve Disable-AzureRmAlias. Enable-AzureRmAlias AzureRM'de, daha yeni Az cmdlet adlarla eşenen eski cmdlet adları için diğer adlar oluşturur. Bağımsız -Scope değişkenin Enable-AzureRmAlias kullanımı, diğer adların etkinleştirildikten sonra nerede etkinleştiril adlarını seçmenize olanak sağlar.

Örneğin, AzureRM'de aşağıdaki betik:

#Requires -Modules AzureRM.Storage
Get-AzureRmStorageAccount | Get-AzureStorageContainer | Get-AzureStorageBlob

Şu kullanılarak en az değişiklikle Enable-AzureRmAlias çalıştırın:

#Requires -Modules Az.Storage
Enable-AzureRmAlias -Scope Process
Get-AzureRmStorageAccount | Get-AzureStorageContainer | Get-AzureStorageBlob

Çalışan, açık olan tüm PowerShell oturumlarının diğer adlarını etkinleştirir, böylece bu cmdlet'i yürütttürdikten sonra bunun gibi bir betiğin hiç Enable-AzureRmAlias -Scope CurrentUser değişmesi gerek olmaz:

Get-AzureRmStorageAccount | Get-AzureStorageContainer | Get-AzureStorageBlob

Diğer ad cmdlet'lerinin kullanımıyla ilgili tüm ayrıntılar için bkz. Enable-AzureRmAlias başvurusu.

Diğer adları devre dışı bırakmak için hazır olduktan sonra, Disable-AzureRmAlias oluşturulan diğer adları kaldırır. Tüm ayrıntılar için Bkz. Disable-AzureRmAlias başvurusu.

Önemli

Diğer adları devre dışı bırakarak, diğer adların etkin olduğu tüm kapsamlar için bunların devre dışı bırakıldıklerinden emin olun.

Modül Adı Değişiklikleri

Aşağıdaki modüller dışında, AzureRM.* Az.* modül adları olarak değiştirilmiştir:

AzureRM modülü Az modülü
Azure. Depolama Az.Depolama
Azure.AnalysisServices Az.AnalysisServices
AzureRM.Profile Az.Accounts
AzureRM. Analizler Az.Monitör
AzureRM.DataFactories Az.DataFactory
AzureRM.DataFactoryV2 Az.DataFactory
AzureRM.RecoveryServices.Backup Az.RecoveryServices
AzureRM.RecoveryServices.SiteRecovery Az.RecoveryServices
AzureRM.Etiketler Az.Resources
AzureRM.MachineLearningCompute Az.MachineLearning
AzureRM.UsageAggregates Az.Billing
AzureRM.Consumption Az.Billing

Modül adlarında yapılan değişiklikler, belirli modülleri kullanan veya yüklemek için gereken tüm betiklerin, bunun yerine yeni modülü kullanmak #Requires Import-Module üzere değiştir gerekecekleri anlamına geliyor. Cmdlet soneki değişmemiş modüller için bu, modül adı değişse de, işlem alanı için sonek değişmemiş olduğu anlamına gelir.

Son #Requires ve Import-Module'leri

AzureRM modüllerine bağımlılık ifade eden veya kullanan #Requires Import-Module betikler, yeni modül adlarını kullanmak üzere güncelleştirilebilir. Örneğin:

#Requires -Module AzureRM.Compute

Şu şekilde değiştirilir:

#Requires -Module Az.Compute

Import-ModuleIçin:

Import-Module -Name AzureRM.Compute

Şu şekilde değiştirilir:

Import-Module -Name Az.Compute

Cmdlet İptal Fully-Qualified'e Giriş

Modül nitelikli cmdlet çağırmalarını kullanan betikler; örneğin:

AzureRM.Compute\Get-AzureRmVM

Yeni modülü ve cmdlet adlarını kullanmak için değiştiriliyor olmalıdır:

Az.Compute\Get-AzVM

Modülün bildirim bağımlılıklarınıgragrama

AzureRM modüllerine bağımlılıkları modül bildirimi (.psd1) dosyası aracılığıyla ifade eden modüllerin kendi bölümünde modül adlarını güncelleştirmeleri RequiredModules gerekir:

RequiredModules = @(@{ModuleName="AzureRM.Profile"; ModuleVersion="5.8.2"})

Şu şekilde değiştir gerekir:

RequiredModules = @(@{ModuleName="Az.Profile"; ModuleVersion="1.0.0"})

Modüller kaldırıldı

Aşağıdaki modüller kaldırıldı:

  • AzureRM.Backup
  • AzureRM.Compute.ManagedService
  • AzureRM.Scheduler

Bu hizmetlerin araçları artık etkin olarak desteklenmiyor. Müşterilerin uygun olduğu anda alternatif hizmetlere yönelleriz.

Windows PowerShell 5.1 ve .NET 4.7.2

Az'ı powershell 5.1 ile Windows için .NET Framework 4.7.2'nin yüklenmesi gerekir. PowerShell Core 6.x veya sonraki bir .NET Framework.

PSCredential kullanarak Kullanıcı oturumu açma geçici olarak kaldırma

.NET Standard için kimlik doğrulama akışında yapılan değişiklikler nedeniyle, PSCredential aracılığıyla kullanıcı oturumlarını geçici olarak kaldırmış oluruz. Bu özellik, Windows için PowerShell 5.1 için 15/1/2019 sürümüyle yeniden Windows. Bu konu, bu konu ile ilgili GitHub ele alınmaktadır.

Web tarayıcısı istemi yerine varsayılan cihaz kodu oturumu açma

.NET Standard için kimlik doğrulama akışında yapılan değişikliklerden dolayı, etkileşimli oturum açma sırasında cihaz oturum açma akışını varsayılan oturum açma akışı olarak kullanıyoruz. 15/1/2019 sürümü varsayılan olarak Windows için PowerShell 5.1 için web tarayıcısı tabanlı oturum açma yeniden başlayacaktır. Bu sırada, kullanıcılar Switch parametresini kullanarak cihaz oturum açma bilgilerini seçebilir.

Modül son değişiklikleri

Bu bölümde, tek tek modüller ve cmdlet'ler için belirli son dakika değişiklikleri ayrıntılarıyla açık bulunur.

Az.ApiManagement (daha önce AzureRM.ApiManagement)

  • Aşağıdaki cmdlet'ler kaldırıldı:
    • New-AzureRmApiManagementHostnameConfiguration
    • Set-AzureRmApiManagementHostnames
    • Update-AzureRmApiManagementDeployment
    • Import-AzureRmApiManagementHostnameCertificate
    • Bunun yerine bu özellikleri ayarlamak için Set-AzApiManagement cmdlet'ini kullanın
  • Aşağıdaki özellikler kaldırıldı:
    • Özelliği PortalHostnameConfiguration , ProxyHostnameConfiguration ve türü ManagementHostnameConfiguration ScmHostnameConfiguration 'dan PsApiManagementHostnameConfiguration PsApiManagementContext kaldırıldı. Bunun yerine PortalCustomHostnameConfiguration ProxyCustomHostnameConfiguration , ve ManagementCustomHostnameConfiguration ScmCustomHostnameConfiguration PsApiManagementCustomHostNameConfiguration yazın.
    • Özelliği StaticIPs PsApiManagementContext'den kaldırıldı. Özellik ve içine PublicIPAddresses bölünmüş. PrivateIPAddresses
    • LocationCmdlet'in New-AzureApiManagementVirtualNetwork kaldırıldı.

Az.Billing (daha önce AzureRM.Billing, AzureRM.Consumption ve AzureRM.UsageAggregates)

  • Parametre InvoiceName Get-AzConsumptionUsageDetail cmdlet'inden kaldırıldı. Betiklerin fatura için diğer kimlik parametrelerini kullanmaları gerekir.

Az.CognitiveServices (önceki AzureRM.CognitiveServices)

  • GetSkusWithAccountParamSetName Get-AzCognitiveServicesAccountSkus cmdlet'den parametre kümesi kaldırıldı. Sku'ları ResourceGroupName ve Account Name kullanmak yerine Hesap Türü ve Konum'a göre alısınız.

Az.Compute (önceki AzureRM.Compute)

  • IdentityIds ve nesnelerdeki Identity PSVirtualMachine özellikten kaldırılır Betikler, işleme kararları almak PSVirtualMachineScaleSet için artık bu alanın değerini kullanmaz.
  • Nesnenin InstanceView özelliği PSVirtualMachineScaleSetVM türü, VirtualMachineInstanceView``VirtualMachineScaleSetVMInstanceView
  • AutoOSUpgradePolicy ve AutomaticOSUpgrade özellikler özellikten UpgradePolicy kaldırılır
  • Nesnede Sku PSSnapshotUpdate özelliğin türü, DiskSku``SnapshotSku
  • VmScaleSetVMParameterSet``Add-AzVMDataDiskcmdlet'den kaldırılır, artık ScaleSet VM'ye tek tek veri diski ekamazsiniz.

Az.DataFactory (daha önce AzureRM.DataFactories ve AzureRM.DataFactoryV2)

  • GatewayNameCmdlet'te parametre New-AzDataFactoryEncryptValue zorunlu hale getirildi
  • New-AzDataFactoryGatewayKeyCmdlet kaldırıldı
  • LinkedServiceName Get-AzDataFactoryV2ActivityRun cmdlet Betiklerinden parametre kaldırıldı Betikler, işleme kararları almak için artık bu alanın değerini kullanmaz.

Az.DataLakeAnalytics (daha önce AzureRM.DataLakeAnalytics)

  • Kullanımdan kaldırılan cmdlet'ler: New-AzDataLakeAnalyticsCatalogSecret , Remove-AzDataLakeAnalyticsCatalogSecret ve Set-AzDataLakeAnalyticsCatalogSecret

Az.DataLakeStore (daha önce AzureRM.DataLakeStore)

  • Aşağıdaki cmdlet'lerde Encoding parametrenin türden . FileSystemCmdletProviderEncoding System.Text.Encoding Bu değişiklik kodlama değerlerini ve String . Oem Önceki tüm diğer kodlama değerleri kalır.

    • New-AzureRmDataLakeStoreItem
    • Add-AzureRmDataLakeStoreItemContent
    • Get-AzureRmDataLakeStoreItemContent

  • Kullanımdan kaldırılan özellik Tags diğer adı New-AzDataLakeStoreAccount ve Set-AzDataLakeStoreAccount cmdlet'ler

    Komut dosyası kullanımı

    New-AzureRMDataLakeStoreAccount -Tags @{TagName="TagValue"}

    Şu şekilde değiştir olmalı:

    New-AzDataLakeStoreAccount -Tag @{TagName="TagValue"}

  • Nesneden kullanımdan kaldırılan özellikler , , , , , , , , . Identity EncryptionState EncryptionProvisioningState EncryptionConfig FirewallState FirewallRules VirtualNetworkRules TrustedIdProviderState TrustedIdProviders DefaultGroup NewTier CurrentTier FirewallAllowAzureIps PSDataLakeStoreAccountBasic . Döndürülen özelliği kullanan PSDatalakeStoreAccount betikler Get-AzDataLakeStoreAccount bu özelliklere başvuramaz.

Az.KeyVault (daha önce AzureRM.KeyVault)

  • Özellik , ve nesnelerden kaldırıldı Betikler artık işleme kararları almak PurgeDisabled için PSKeyVaultKeyAttributes PSKeyVaultKeyIdentityItem PSKeyVaultSecretAttributes PurgeDisabled özellilere başvuramaz.

Az.Media (önceki azurerm.media)

  • Cmdlet Betiklerinden kullanımdan kaldır Tags özellik diğer New-AzMediaService adını

    New-AzureRMMediaService -Tags @{TagName="TagValue"}

    Şu şekilde değiştir olmalı:

    New-AzMediaService -Tag @{TagName="TagValue"}

Az.Monitor (önceki azurerm.Analizler)

  • Cmdlet Categories Betiklerinden tekil parametre adlarının olumlu olarak kaldırılmış Timegrains Set-AzDiagnosticSetting çoğulları ve parametre

    Set-AzureRmDiagnosticSetting -Timegrains PT1M -Categories Category1, Category2

    Şu şekilde değiştir olmalı:

    Set-AzDiagnosticSetting -Timegrain PT1M -Category Category1, Category2

Az.Network (önceki azurerm.network)

  • ResourceIdCmdlet'in kullanımdan Get-AzServiceEndpointPolicyDefinition kaldırılan parametresi
  • Nesneden kullanımdan EnableVmProtection kaldırılan PSVirtualNetwork özellik
  • Kullanımdan kaldırılan Set-AzVirtualNetworkGatewayVpnClientConfig cmdlet

Betikler artık bu alanların değerlerine dayalı olarak kararlar işleme almaz.

Az.OperationalInsights (daha önce AzureRM.OperationalInsights)

  • için varsayılan parametre Get-AzOperationalInsightsDataSource kümesi kaldırılır ve varsayılan parametre kümesi haline ByWorkspaceNameByKind geldi

    Veri kaynaklarını listeleen betikler

    Get-AzureRmOperationalInsightsDataSource

    Bir Tür belirterek değiştirnsin

    Get-AzOperationalInsightsDataSource -Kind AzureActivityLog

Az.RecoveryServices (daha önce AzureRM.RecoveryServices, AzureRM.RecoveryServices.Backup ve AzureRM.RecoveryServices.SiteRecovery)

  • Encryption New/Set-AzRecoveryServicesAsrPolicy cmdlet'den parametre kaldırıldı
  • TargetStorageAccountName cmdlet'te yönetilen disk geri yüklemeleri için artık Restore-AzRecoveryServicesBackupItem parametre zorunludur
  • StorageAccountName StorageAccountResourceGroupName Restore-AzRecoveryServicesBackupItem Cmdlet'te kaldırıldı ve parametreler
  • Name Get-AzRecoveryServicesBackupContainer cmdlet'te parametre kaldırıldı

Az.Resources (önceki azurerm.resources)

  • Sku New/Set-AzPolicyAssignment cmdlet'den parametre kaldırıldı

  • Parametre Password ve New-AzADServicePrincipal New-AzADSpCredential cmdlet Parolaları, parolayı sağlanan betikler otomatik olarak oluşturulur:

    New-AzAdSpCredential -ObjectId 1f99cf81-0146-4f4e-beae-2007d0668476 -Password $secPassword

    Parolayı çıkıştan almak için değiştirnsin mi:

    $credential = New-AzAdSpCredential -ObjectId 1f99cf81-0146-4f4e-beae-2007d0668476
$secPassword = $credential.Secret

Az.ServiceFabric (daha önce AzureRM.ServiceFabric)

  • Aşağıdaki cmdlet dönüş türleri değiştirildi:
    • Tür ServiceTypeHealthPolicies özelliği ApplicationHealthPolicy kaldırılmıştır.
    • Tür ApplicationHealthPolicies özelliği ClusterUpgradeDeltaHealthPolicy kaldırılmıştır.
    • Tür OverrideUserUpgradePolicy özelliği ClusterUpgradePolicy kaldırılmıştır.
    • Bu değişiklikler aşağıdaki cmdlet'leri etkiler:
      • Add-AzServiceFabricClientCertificate
      • Add-AzServiceFabricClusterCertificate
      • Add-AzServiceFabricNode
      • Add-AzServiceFabricNodeType
      • Get-AzServiceFabricCluster
      • Remove-AzServiceFabricClientCertificate
      • Remove-AzServiceFabricClusterCertificate
      • Remove-AzServiceFabricNode
      • Remove-AzServiceFabricNodeType
      • Remove-AzServiceFabricSetting
      • Set-AzServiceFabricSetting
      • Set-AzServiceFabricUpgradeType
      • Update-AzServiceFabricDurability
      • Update-AzServiceFabricReliability

Az.Sql (önceki azurerm.sql)

  • State ResourceId Set-AzSqlDatabaseBackupLongTermRetentionPolicy Cmdlet'den kaldırıldı ve parametreler
  • Kullanımdan kaldırılan cmdlet'ler: Get/Set-AzSqlServerBackupLongTermRetentionVault , Get/Start/Stop-AzSqlServerUpgrade , , Get/Set-AzSqlDatabaseAuditingPolicy Get/Set-AzSqlServerAuditingPolicy , Remove-AzSqlDatabaseAuditing``Remove-AzSqlServerAuditing
  • CurrentCmdlet'in kullanımdan Get-AzSqlDatabaseBackupLongTermRetentionPolicy kaldırılan parametresi
  • DatabaseNameCmdlet'in kullanımdan Get-AzSqlServerServiceObjective kaldırılan parametresi
  • PrivilegedLoginCmdlet'in kullanımdan Set-AzSqlDatabaseDataMaskingPolicy kaldırılan parametresi

Az.Depolama (önceki azure.Depolama AzureRM. Depolama)

  • Yalnızca depolama hesabı adıyla bir Oauth depolama bağlamı oluşturmayı desteklemek için, varsayılan parametre kümesi OAuthParameterSet
    • Örnek: $ctx = New-AzureStorageContext -StorageAccountName $accountName
  • LocationCmdlet'te parametre Get-AzStorageUsage zorunlu hale getirildi
  • Aşağıdaki Depolama API yöntemleri, zaman uyumlu API çağrıları yerine artık Görev Tabanlı Zaman Uyumsuz Desen (TAP) kullanır. Aşağıdaki örneklerde yeni zaman uyumsuz komutlar göster hatalıdır:

Blob Anlık Görüntüsü

AzureRM:

$b = Get-AzureStorageBlob -Container $containerName -Blob $blobName -Context $ctx
$b.ICloudBlob.Snapshot()

Az:

$b = Get-AzStorageBlob -Container $containerName -Blob $blobName -Context $ctx
$task = $b.ICloudBlob.SnapshotAsync()
$task.Wait()
$snapshot = $task.Result

Anlık Görüntüyü Paylaş

AzureRM:

$Share = Get-AzureStorageShare -Name $containerName -Context $ctx
$snapshot = $Share.Snapshot()

Az:

$Share = Get-AzStorageShare -Name $containerName -Context $ctx
$task = $Share.SnapshotAsync()
$task.Wait()
$snapshot = $task.Result

Silinmiş yumuşak blob silmeyi geri silme

AzureRM:

$b = Get-AzureStorageBlob -Container $containerName -Blob $blobName -IncludeDeleted -Context $ctx
$b.ICloudBlob.Undelete()

Az:

$b = Get-AzStorageBlob -Container $containerName -Blob $blobName -IncludeDeleted -Context $ctx
$task = $b.ICloudBlob.UndeleteAsync()
$task.Wait()

Blob Katmanı'nın katmanlarını ayarlama

AzureRM:

$blockBlob = Get-AzureStorageBlob -Container $containerName -Blob $blockBlobName -Context $ctx
$blockBlob.ICloudBlob.SetStandardBlobTier("hot")

$pageBlob = Get-AzureStorageBlob -Container $containerName -Blob $pageBlobName -Context $ctx
$pageBlob.ICloudBlob.SetPremiumBlobTier("P4")

Az:

$blockBlob = Get-AzStorageBlob -Container $containerName -Blob $blockBlobName -Context $ctx
$task = $blockBlob.ICloudBlob.SetStandardBlobTierAsync("hot")
$task.Wait()

$pageBlob = Get-AzStorageBlob -Container $containerName -Blob $pageBlobName -Context $ctx
$task = $pageBlob.ICloudBlob.SetPremiumBlobTierAsync("P4")
$task.Wait()

Az.Web Siteleri (önceki azurerm.web siteleri)

  • , ve nesnelerden kullanımdan PSAppServicePlan PSCertificate PSCloningInfo kaldırılan PSSite özellikler