Поделиться через

Кардинальные изменения для Az 1.0.0

  • Статья

В этом документе содержатся подробные сведения об изменениях между AzureRM 6.x и новым модулем Az версии 1.x и более поздними версиями. Пункты в оглавлении помогут вам разобраться со всеми этапами переноса, включая изменения модуля, которые могут повлиять на скрипты.

Общие советы по началу перехода с Az на AzureRM см. в этой статье.

Это важно

There have been breaking changes between Az 1.0.0 and Az 2.0.0 as well. Выполнив действия по переходу с AzureRM на Az, представленные в этом руководстве, перейдите к статье о критических изменениях в Az 2.0.0, чтобы узнать, необходимо ли вам внести дополнительные изменения.

Оглавление

General breaking changes

В этом разделе описаны общие изменения, которые являются частью переработки модуля Az.

Cmdlet Noun Prefix Changes

В модуле AzureRM префикс AzureRM или Azure используется в названиях командлетов как существительное. Az simplifies and normalizes cmdlet names, so that all cmdlets use 'Az' as their cmdlet noun prefix. Рассмотрим пример.

Get-AzureRMVM
Get-AzureKeyVaultSecret

Изменилось на:

Get-AzVM
Get-AzKeyVaultSecret

Чтобы упростить переход на эти новые имена командлетов, Az представляет два новых командлета: Enable-AzureRmAlias и Disable-AzureRmAlias. Enable-AzureRmAlias создает псевдонимы для старых имен командлетов в AzureRM, соответствующие новым именам командлетов Az. Использование аргумента -Scope с Enable-AzureRmAlias позволяет выбрать, где активированы псевдонимы.

Например, следующий сценарий в AzureRM:

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

Его можно выполнить с минимальными изменениями с помощью Enable-AzureRmAlias.

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

Запуск Enable-AzureRmAlias -Scope CurrentUser активирует псевдонимы для всех открытых сеансов PowerShell, так что после выполнения этого командлета сценарий, подобный этому, не нужно будет изменять вообще, например:

Get-AzureRmStorageAccount | Get-AzureStorageContainer | Get-AzureStorageBlob

For complete details on the usage of the alias cmdlets, see the Enable-AzureRmAlias reference.

Когда вы будете готовы отключить псевдонимы, Disable-AzureRmAlias удаляет созданные псевдонимы. Полную информацию см. в справочнике Disable-AzureRmAlias.

Это важно

Убедитесь, что отключили псевдонимы для всех областей, в которых они были включены.

Изменения имени модуля

Имена модулей изменились с AzureRM.* на Az.*, за исключением следующих модулей:

Модуль AzureRM Модуль Az
Azure.Storage Az.Storage
Azure.AnalysisServices Az.AnalysisServices
AzureRM.Profile Az.Учетные записи
AzureRM.Insights Аз.Монитор
AzureRM.DataFactories Az.DataFactory
AzureRM.DataFactoryV2 Az.DataFactory
AzureRM.RecoveryServices.Backup Az.RecoveryServices (службы восстановления Azure)
AzureRM.RecoveryServices.SiteRecovery Az.RecoveryServices (службы восстановления Azure)
AzureRM.Tags Аз.Ресурсы
AzureRM.MachineLearningCompute Az.MachineLearning
AzureRM.UsageAggregates Az.Billing
AzureRM.Потребление Az.Billing

Изменения в именах модулей означают, что любой сценарий, который использует #Requires или Import-Module для загрузки определенных модулей, необходимо будет изменить, чтобы вместо него использовать новый модуль. Для модулей, где суффикс командлета не изменился, это означает, что хотя имя модуля изменилось, суффикс, указывающий пространство операций, имеет , а не.

Migrating #Requires and Import-Module Statements

Скрипты, использующие #Requires или Import-Module для объявления зависимости от модулей AzureRM, необходимо обновить, чтобы использовать новые имена модулей. Рассмотрим пример.

#Requires -Module AzureRM.Compute

Необходимо изменить следующее:

#Requires -Module Az.Compute

Для Import-Module:

Import-Module -Name AzureRM.Compute

Необходимо изменить следующее:

Import-Module -Name Az.Compute

Миграция полных команд аплетов

Scripts that use module-qualified cmdlet invocations, such as:

AzureRM.Compute\Get-AzureRmVM

Необходимо изменить, чтобы использовать новые названия модулей и командлетов.

Az.Compute\Get-AzVM

Перенос зависимостей манифеста модуля

Модули, которые выражают зависимости от модулей AzureRM с помощью файла манифеста модуля (PSD1), должны обновить имена модулей в разделе RequiredModules:

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

Необходимо изменить следующее:

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

Удаленные модули

Следующие модули удалены:

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

Инструменты для этих услуг больше не поддерживаются активно. Клиентам рекомендуется перейти к альтернативным службам, как только это удобно.

Windows PowerShell 5.1 и .NET 4.7.2

Для использования Az с PowerShell 5.1 для Windows требуется установить .NET Framework 4.7.2. Использование PowerShell Core 6.x или более поздней версии не требует .NET Framework.

Временное удаление входа пользователя с помощью PSCredential

Из-за изменений в процессе проверки подлинности для .NET Standard мы временно удаляем вход пользователя через PSCredential. Эта возможность будет повторно представлена в выпуске 1.15.2019 для PowerShell 5.1 для Windows. Это подробно описано в этом сообщении на сайте GitHub.

Вход по умолчанию с помощью кода устройства вместо запроса на вход через веб-браузер.

В связи с изменениями в процессе аутентификации для .NET Standard, мы используем вход через устройство в качестве основного метода входа при интерактивной авторизации. Вход с использованием веб-браузера будет вновь введён в PowerShell 5.1 для Windows по умолчанию в выпуске от 15.01.2019. В этот момент пользователи смогут выбрать вход на устройство с помощью параметра Switch.

Module breaking changes

This section details specific breaking changes for individual modules and cmdlets.

Az.ApiManagement (ранее AzureRM.ApiManagement)

  • Removed the following cmdlets:
    • New-AzureRmApiManagementHostnameConfiguration
    • Set-AzureRmApiManagementHostnames
    • Update-AzureRmApiManagementDeployment
    • Import-AzureRmApiManagementHostnameCertificate
    • Use Set-AzApiManagement cmdlet to set these properties instead
  • Удалены следующие свойства:
    • Удалено свойство PortalHostnameConfiguration, ProxyHostnameConfiguration, ManagementHostnameConfiguration и ScmHostnameConfiguration типа PsApiManagementHostnameConfiguration из PsApiManagementContext. Вместо этого используйте: PortalCustomHostnameConfiguration, ProxyCustomHostnameConfiguration, ManagementCustomHostnameConfiguration и ScmCustomHostnameConfiguration типа PsApiManagementCustomHostNameConfiguration.
    • Удалено свойство StaticIPs из PsApiManagementContext. Свойство было разделено на PublicIPAddresses и PrivateIPAddresses.
    • Удалено обязательное свойство Location из командлета New-AzureApiManagementVirtualNetwork.

Az.Billing (ранее AzureRM.Billing, AzureRM.Consumption и AzureRM.UsageAggregates)

  • Параметр InvoiceName был удален из командлета Get-AzConsumptionUsageDetail. Скрипты должны использовать другие параметры идентификации для счета-фактуры.

Az.CognitiveServices (ранее AzureRM.CognitiveServices)

  • Удалён набор параметров GetSkusWithAccountParamSetName из команды Get-AzCognitiveServicesAccountSkus. Необходимо получить Skus по типу и расположению учетной записи, а не использовать ResourceGroupName и имя учетной записи.

Az.Compute (ранее AzureRM.Compute)

  • IdentityIds удаляются из свойства Identity в объектах PSVirtualMachine и PSVirtualMachineScaleSet. Скрипты больше не должны использовать значение этого поля для принятия решений об обработке.
  • Тип свойства InstanceView объекта PSVirtualMachineScaleSetVM изменен с VirtualMachineInstanceView на VirtualMachineScaleSetVMInstanceView
  • Свойства AutoOSUpgradePolicy и AutomaticOSUpgrade удалены из свойства UpgradePolicy
  • Тип свойства Sku в объекте PSSnapshotUpdate изменен с DiskSku на SnapshotSku
  • VmScaleSetVMParameterSet удаляется из командлета Add-AzVMDataDisk, вы больше не можете добавить диск данных отдельно в виртуальную машину ScaleSet.

Az.DataFactory (ранее AzureRM.DataFactories и AzureRM.DataFactoryV2)

  • Параметр GatewayName стал обязательным в командлете New-AzDataFactoryEncryptValue
  • Removed New-AzDataFactoryGatewayKey cmdlet
  • Параметр LinkedServiceName был удалён из командлета Get-AzDataFactoryV2ActivityRun. Скриптам больше запрещается использовать значение этого параметра для принятия решений по обработке.

Az.DataLakeAnalytics (ранее AzureRM.DataLakeAnalytics)

  • Removed deprecated cmdlets: New-AzDataLakeAnalyticsCatalogSecret, Remove-AzDataLakeAnalyticsCatalogSecret, and Set-AzDataLakeAnalyticsCatalogSecret

Az.DataLakeStore (ранее AzureRM.DataLakeStore)

  • The following cmdlets have had the Encoding parameter changed from the type FileSystemCmdletProviderEncoding to System.Text.Encoding. Это изменение удаляет значения кодировки String и Oem. Все остальные предыдущие значения кодирования остаются.

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

  • Удален устаревший псевдоним свойства Tags из командлетов New-AzDataLakeStoreAccount и Set-AzDataLakeStoreAccount.

    Scripts using

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

    Должно быть изменено на

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

  • Удалены устаревшие свойства Identity, EncryptionState, EncryptionProvisioningState, EncryptionConfig, FirewallState, FirewallRules, VirtualNetworkRules, TrustedIdProviderState, TrustedIdProviders, DefaultGroup, NewTier, CurrentTier, FirewallAllowAzureIps из объекта PSDataLakeStoreAccountBasic. Любой сценарий, который использует PSDatalakeStoreAccount, возвращенный из Get-AzDataLakeStoreAccount, не должен ссылаться на эти свойства.

Az.KeyVault (ранее AzureRM.KeyVault)

  • Свойство PurgeDisabled удалено из объектов PSKeyVaultKeyAttributes, PSKeyVaultKeyIdentityItem и PSKeyVaultSecretAttributes. Скрипты больше не должны ссылаться на свойство PurgeDisabled для принятия решений об обработке.

Az.Media (ранее AzureRM.Media)

  • Remove deprecated Tags property alias from New-AzMediaService cmdlet Scripts using

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

    Должно быть изменено на

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

Az.Monitor (ранее AzureRM.Insights)

  • Removed plural names Categories and Timegrains parameter in favor of singular parameter names from Set-AzDiagnosticSetting cmdlet Scripts using

    Set-AzureRmDiagnosticSetting -Timegrains PT1M -Categories Category1, Category2

    Должно быть изменено на

    Set-AzDiagnosticSetting -Timegrain PT1M -Category Category1, Category2

Az.Network (ранее AzureRM.Network)

  • Удалён устаревший параметр ResourceId из команды Get-AzServiceEndpointPolicyDefinition cmdlet
  • Из объекта EnableVmProtection удалено устаревшее свойство PSVirtualNetwork
  • Removed deprecated Set-AzVirtualNetworkGatewayVpnClientConfig cmdlet

Скрипты больше не должны принимать решения по обработке на основе значений этих полей.

Az.OperationalInsights (ранее AzureRM.OperationalInsights)

  • Набор параметров по умолчанию для Get-AzOperationalInsightsDataSource удаляется, и ByWorkspaceNameByKind стал набором параметров по умолчанию.

    Сценарии, в которых перечислены источники данных, которые использованы

    Get-AzureRmOperationalInsightsDataSource

    Should be changed to specify a Kind

    Get-AzOperationalInsightsDataSource -Kind AzureActivityLog

Az.RecoveryServices (ранее AzureRM.RecoveryServices, AzureRM.RecoveryServices.Backup и AzureRM.RecoveryServices.SiteRecovery)

  • Removed Encryption parameter from New/Set-AzRecoveryServicesAsrPolicy cmdlet
  • параметр TargetStorageAccountName теперь является обязательным для восстановления управляемого диска в командлете Restore-AzRecoveryServicesBackupItem
  • Удалены параметры StorageAccountName и StorageAccountResourceGroupName в командлете Restore-AzRecoveryServicesBackupItem
  • Удален параметр Nameв командлете Get-AzRecoveryServicesBackupContainer

Az.Resources (ранее AzureRM.Resources)

  • Удален Sku параметр из New/Set-AzPolicyAssignment cmdlet

  • Удален параметр Password из командлетов New-AzADServicePrincipal и New-AzADSpCredential, пароли генерируются автоматически. Скрипты, которые предоставляли пароль:

    New-AzAdSpCredential -ObjectId 00001111-aaaa-2222-bbbb-3333cccc4444 -Password $secPassword

    Должно быть изменено, чтобы извлечь пароль из вывода.

    $credential = New-AzAdSpCredential -ObjectId 00001111-aaaa-2222-bbbb-3333cccc4444
$secPassword = $credential.Secret

Az.ServiceFabric (ранее AzureRM.ServiceFabric)

  • The following cmdlet return types have been changed:
    • Свойство ServiceTypeHealthPolicies типа ApplicationHealthPolicy удалено.
    • Свойство ApplicationHealthPolicies типа ClusterUpgradeDeltaHealthPolicy удалено.
    • Свойство OverrideUserUpgradePolicy типа ClusterUpgradePolicy удалено.
    • Эти изменения влияют на следующие командлеты:
      • 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 (ранее AzureRM.Sql)

  • Удалены параметры State и ResourceId из командлета Set-AzSqlDatabaseBackupLongTermRetentionPolicy
  • Removed deprecated cmdlets: Get/Set-AzSqlServerBackupLongTermRetentionVault, Get/Start/Stop-AzSqlServerUpgrade, Get/Set-AzSqlDatabaseAuditingPolicy, Get/Set-AzSqlServerAuditingPolicy, Remove-AzSqlDatabaseAuditing, Remove-AzSqlServerAuditing
  • Удалён устаревший параметр Current в командлете Get-AzSqlDatabaseBackupLongTermRetentionPolicy
  • Удалён устаревший параметр DatabaseName в командлете Get-AzSqlServerServiceObjective
  • Удалён устаревший параметр PrivilegedLogin в командлете Set-AzSqlDatabaseDataMaskingPolicy

Az.Storage (ранее Azure.Storage и AzureRM.Storage)

  • Для поддержки создания контекста хранения Oauth только с именем учетной записи хранения набор параметров по умолчанию был изменен на OAuthParameterSet.
    • Пример: $ctx = New-AzureStorageContext -StorageAccountName $accountName
  • Параметр Location стал обязательным в командлете Get-AzStorageUsage
  • Методы API хранилища теперь используют асинхронный шаблон на основе задач (TAP), а не синхронные вызовы API. В следующих примерах показаны новые асинхронные команды:

Blob Snapshot

AzureRM:

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

Азербайджан:

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

Поделиться снимком экрана

AzureRM:

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

Аз:

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

Undelete soft-deleted blob

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

Set Blob Tier

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.Websites (ранее AzureRM.Websites)

  • Удалены устаревшие свойства из объектов PSAppServicePlan, PSCertificate, PSCloningInfoи PSSite