Az 1.0.0의 호환성을 깨뜨리는 변경 사항
이 문서에서는 AzureRM 6.x와 새 Az 모듈 버전 1.x 이상 간의 변경 내용에 대한 자세한 정보를 제공합니다. 목차는 스크립트에 영향을 줄 수 있는 모듈별 변경 내용을 포함하여 전체 마이그레이션 경로를 안내하는 데 도움이 됩니다.
AzureRM에서 Az로 마이그레이션을 시작하는 데 대한 일반적인 조언은 AzureRM에서 Az마이그레이션 시작을 참조하세요.
중요하다
Az 1.0.0과 Az 2.0.0 간에도 중대한 변경이 있었습니다. AzureRM에서 Az로 업데이트하는 방법에 대한 이 가이드를 수행한 후 Az 2.0.0 호환성이 손상되는 변경 참조하여 추가 변경이 필요한지 확인합니다.
목차
-
전반적인 중대한 변경 사항
- cmdlet 명사 접두사 변경
- 모듈 이름 변경
- 제거된 모듈
- Windows PowerShell 5.1 및 .NET 4.7.2
- PSCredential 사용하여 사용자 로그인의 임시 제거
- 웹 브라우저 프롬프트 대신 기본 디바이스 코드 로그인
-
모듈 호환성이 손상되는 변경
- Az.ApiManagement(이전에는 AzureRM.ApiManagement)
- Az.Billing(이전에는 AzureRM.Billing, AzureRM.Consumption 및 AzureRM.UsageAggregates)
- Az.CognitiveServices(이전에는 AzureRM.CognitiveServices)
- Az.Compute(이전에는 AzureRM.Compute)
- Az.DataFactory(이전에는 AzureRM.DataFactories 및 AzureRM.DataFactoryV2)
- Az.DataLakeAnalytics(이전에는 AzureRM.DataLakeAnalytics)
- Az.DataLakeStore(이전에는 AzureRM.DataLakeStore)
- Az.KeyVault(이전에는 AzureRM.KeyVault)
- Az.Media(이전에는 AzureRM.Media)
- Az.Monitor(이전에는 AzureRM.Insights)
- Az.Network(이전에는 AzureRM.Network)
- Az.OperationalInsights(이전에는 AzureRM.OperationalInsights)
- Az.RecoveryServices(이전에는 AzureRM.RecoveryServices, AzureRM.RecoveryServices.Backup 및 AzureRM.RecoveryServices.SiteRecovery)
- Az.Resources(이전에는 AzureRM.Resources)
- Az.ServiceFabric(이전에는 AzureRM.ServiceFabric)
- Az.Sql(이전에는 AzureRM.Sql)
- Az.Storage(이전에는 Azure.Storage 및 AzureRM.Storage)
- Az.Websites(이전에는 AzureRM.Websites)
일반적인 호환성이 손상되는 변경
이 섹션에서는 Az 모듈 재설계의 일부인 일반적인 주요 변경 내용을 자세히 설명합니다.
Cmdlet 명사 접두사 변경
AzureRM 모듈에서 cmdlet은 AzureRM
또는 Azure
명사 접두사로 사용했습니다. Az는 cmdlet 이름을 간소화하고 정규화하므로 모든 cmdlet은 'Az'를 cmdlet 명사 접두사로 사용합니다. 예를 들어:
Get-AzureRMVM
Get-AzureKeyVaultSecret
다음으로 변경됨:
Get-AzVM
Get-AzKeyVaultSecret
이러한 새 cmdlet 이름으로의 전환을 더 간단하게 하기 위해 Az는 Enable-AzureRmAlias 및 Disable-AzureRmAlias 두 개의 새 cmdlet을 도입했습니다.
Enable-AzureRmAlias
AzureRM에서 최신 Az cmdlet 이름에 매핑되는 이전 cmdlet 이름에 대한 별칭을 만듭니다.
-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 세션에 별칭이 활성화되므로 이 cmdlet을 실행한 후에는 이와 같은 스크립트를 전혀 변경할 필요가 없습니다.
Get-AzureRmStorageAccount | Get-AzureStorageContainer | Get-AzureStorageBlob
별칭 cmdlet 사용에 대한 자세한 내용은 Enable-AzureRmAlias 참조참조하세요.
별칭을 사용하지 않도록 설정할 준비가 되면 Disable-AzureRmAlias
생성된 별칭을 제거합니다. 자세한 내용은 Disable-AzureRmAlias 참조를 참조하세요.
중요하다
별칭을 사용하지 않도록 설정할 때 별칭이 설정된 모든 범위에 사용할 수 없도록 설정해야 합니다.
모듈 이름 변경
다음 모듈을 제외하고 모듈 이름이 AzureRM.*
Az.*
변경되었습니다.
AzureRM 모듈 | Az 모듈 |
---|---|
Azure.Storage | Az.Storage |
Azure.AnalysisServices | Az.AnalysisServices |
AzureRM.Profile | Az.Accounts |
AzureRM.Insights | Az.Monitor |
AzureRM.DataFactories | Az.DataFactory |
AzureRM.DataFactoryV2 | Az.DataFactory |
AzureRM.RecoveryServices.Backup | Az.RecoveryServices |
AzureRM.RecoveryServices.SiteRecovery | Az.RecoveryServices |
AzureRM.Tags | Az.Resources |
AzureRM.MachineLearningCompute | Az.MachineLearning |
AzureRM.UsageAggregates | Az.Billing |
AzureRM.Consumption | Az.빌링 |
모듈 이름이 변경되면 #Requires
또는 Import-Module
사용하여 특정 모듈을 로드하는 스크립트를 대신 새 모듈을 사용하도록 변경해야 합니다. cmdlet 접미사가 변경되지 않은 모듈의 경우 이는 모듈 이름이 변경되었지만 작업 공간을 나타내는 접미사가 않음을 의미합니다.
#Requires 및 Import-Module 문 이동
#Requires
또는 Import-Module
사용하여 AzureRM 모듈에 대한 종속성을 선언하는 스크립트는 새 모듈 이름을 사용하도록 업데이트해야 합니다. 예를 들어:
#Requires -Module AzureRM.Compute
다음과 같이 변경해야 합니다.
#Requires -Module Az.Compute
Import-Module
경우:
Import-Module -Name AzureRM.Compute
다음으로 변경해야 합니다.
Import-Module -Name Az.Compute
Fully-Qualified Cmdlet 호출 마이그레이션
다음과 같이 모듈 정규화된 cmdlet 호출을 사용하는 스크립트:
AzureRM.Compute\Get-AzureRmVM
새 모듈 및 cmdlet 이름을 사용하도록 변경해야 합니다.
Az.Compute\Get-AzVM
모듈 매니페스트 종속성 마이그레이션
모듈 매니페스트(.psd1) 파일을 통해 AzureRM 모듈에 대한 종속성을 표현하는 모듈은 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
Windows용 PowerShell 5.1에서 Az를 사용하려면 .NET Framework 4.7.2를 설치해야 합니다. PowerShell Core 6.x 이상을 사용하면 .NET Framework가 필요하지 않습니다.
PSCredential을 사용하여 사용자 로그인 임시 제거
.NET Standard의 인증 흐름이 변경되어 PSCredential을 통해 사용자 로그인이 일시적으로 제거됩니다. 이 기능은 Windows용 PowerShell 5.1용 2019/1/15 릴리스에서 다시 도입될 예정입니다. 이 문제는 GitHub 이슈 에서 자세히 논의됩니다.
웹 브라우저 프롬프트 대신 기본 디바이스 코드 로그인
.NET Standard의 인증 흐름이 변경되어 대화형 로그인 중에 디바이스 로그인을 기본 로그인 흐름으로 사용하고 있습니다. 웹 브라우저 기반 로그인은 2019년 1월 15일 릴리스의 기본값으로 Windows용 PowerShell 5.1에 대해 다시 도입됩니다. 이때 사용자는 Switch 매개 변수를 사용하여 디바이스 로그인을 선택할 수 있습니다.
모듈 호환성을 깨는 변경
이 섹션에서는 개별 모듈 및 cmdlet에 대한 특정 주요 변경 내용을 자세히 설명합니다.
Az.ApiManagement(이전에는 AzureRM.ApiManagement)
- 다음 cmdlet을 제거했습니다.
- New-AzureRmApiManagementHostnameConfiguration
- Set-AzureRmApiManagementHostnames
- Update-AzureRmApiManagementDeployment
- Import-AzureRmApiManagementHostnameCertificate
- Set-AzApiManagement cmdlet을 사용하여 이러한 속성을 대신 설정합니다.
- 다음 속성을 제거했습니다.
-
PsApiManagementContext
에서PsApiManagementHostnameConfiguration
형식의 속성PortalHostnameConfiguration
,ProxyHostnameConfiguration
,ManagementHostnameConfiguration
및ScmHostnameConfiguration
가 제거되었습니다. 대신PsApiManagementCustomHostNameConfiguration
형식의PortalCustomHostnameConfiguration
,ProxyCustomHostnameConfiguration
,ManagementCustomHostnameConfiguration
및ScmCustomHostnameConfiguration
사용합니다. - PsApiManagementContext에서 속성
StaticIPs
제거되었습니다. 속성이PublicIPAddresses
과PrivateIPAddresses
으로 분할되었습니다. - New-AzureApiManagementVirtualNetwork cmdlet에서 필수 속성
Location
제거되었습니다.
-
Az.Billing(이전에는 AzureRM.Billing, AzureRM.Consumption 및 AzureRM.UsageAggregates)
-
InvoiceName
매개 변수가Get-AzConsumptionUsageDetail
cmdlet에서 제거되었습니다. 스크립트는 청구서에 다른 ID 매개 변수를 사용해야 합니다.
Az.CognitiveServices(이전에는 AzureRM.CognitiveServices)
-
Get-AzCognitiveServicesAccountSkus
cmdlet에서GetSkusWithAccountParamSetName
매개 변수 집합이 제거되었습니다. ResourceGroupName 및 계정 이름을 사용하는 대신 계정 유형 및 위치별로 SKU를 가져와야 합니다.
Az.Compute(이전에는 AzureRM.Compute)
-
IdentityIds
는PSVirtualMachine
및PSVirtualMachineScaleSet
개체의Identity
속성에서 제거되며, 스크립트는 더 이상 이 필드의 값을 사용하여 처리 결정을 내리지 않아야 합니다. -
PSVirtualMachineScaleSetVM
개체의InstanceView
속성 형식이VirtualMachineInstanceView
에서VirtualMachineScaleSetVMInstanceView
로 변경되었습니다. -
AutoOSUpgradePolicy
및AutomaticOSUpgrade
속성이UpgradePolicy
속성에서 제거됩니다. -
PSSnapshotUpdate
개체의Sku
속성 형식이DiskSku
에서SnapshotSku
으로 변경되었습니다. -
VmScaleSetVMParameterSet
이(가)Add-AzVMDataDisk
cmdlet에서 제거되어, 더 이상 ScaleSet VM에 데이터 디스크를 개별적으로 추가할 수 없습니다.
Az.DataFactory(이전에는 AzureRM.DataFactories 및 AzureRM.DataFactoryV2)
-
New-AzDataFactoryEncryptValue
cmdlet에서GatewayName
매개 변수가 필수가 되었습니다. -
New-AzDataFactoryGatewayKey
cmdlet 제거됨 -
Get-AzDataFactoryV2ActivityRun
cmdlet 스크립트에서 제거된LinkedServiceName
매개 변수는 더 이상 이 필드의 값을 사용하여 처리를 결정하지 않아야 합니다.
Az.DataLakeAnalytics(이전에는 AzureRM.DataLakeAnalytics)
- 사용되지 않는 cmdlet이 제거되었습니다.
New-AzDataLakeAnalyticsCatalogSecret
,Remove-AzDataLakeAnalyticsCatalogSecret
및Set-AzDataLakeAnalyticsCatalogSecret
Az.DataLakeStore(이전에는 AzureRM.DataLakeStore)
다음 cmdlet에는
Encoding
매개 변수가FileSystemCmdletProviderEncoding
형식에서System.Text.Encoding
변경되었습니다. 이렇게 변경하면String
및Oem
인코딩 값이 제거됩니다. 다른 모든 이전 인코딩 값은 그대로 유지되었습니다.- New-AzureRmDataLakeStoreItem
- Add-AzureRmDataLakeStoreItemContent
- Get-AzureRmDataLakeStoreItemContent
New-AzDataLakeStoreAccount
및Set-AzDataLakeStoreAccount
cmdlet에서 사용되지 않는Tags
속성 별칭 제거를 사용하는 스크립트
New-AzureRMDataLakeStoreAccount -Tags @{TagName="TagValue"}
변경해야 합니다.
New-AzDataLakeStoreAccount -Tag @{TagName="TagValue"}
사용되지 않는 속성
Identity
,EncryptionState
,EncryptionProvisioningState
,EncryptionConfig
,FirewallState
,FirewallRules
,VirtualNetworkRules
,TrustedIdProviderState
,TrustedIdProviders
,DefaultGroup
,NewTier
,CurrentTier
,FirewallAllowAzureIps
PSDataLakeStoreAccountBasic
개체에서 제거되었습니다.Get-AzDataLakeStoreAccount
에서 반환된PSDatalakeStoreAccount
을 사용하는 스크립트는 이러한 속성을 참조해서는 안 됩니다.
Az.KeyVault(이전에는 AzureRM.KeyVault)
-
PurgeDisabled
속성은PSKeyVaultKeyAttributes
,PSKeyVaultKeyIdentityItem
및PSKeyVaultSecretAttributes
개체에서 제거되었으며 스크립트는 더 이상PurgeDisabled
속성을 참조하여 처리를 결정하지 않아야 합니다.
Az.Media(이전에는 AzureRM.Media)
를 사용하여 더 이상 사용되지 않는
Tags
속성 별칭을New-AzMediaService
cmdlet 스크립트에서 제거합니다.New-AzureRMMediaService -Tags @{TagName="TagValue"}
변경해야 합니다.
New-AzMediaService -Tag @{TagName="TagValue"}
Az.Monitor(이전에는 AzureRM.Insights)
복수 형태의 이름
Categories
및Timegrains
매개 변수를 제거하고, 단수 매개 변수 이름을 사용하도록Set-AzDiagnosticSetting
cmdlet 스크립트를 사용하는 방법.Set-AzureRmDiagnosticSetting -Timegrains PT1M -Categories Category1, Category2
다음 상태로 변경해야 합니다.
Set-AzDiagnosticSetting -Timegrain PT1M -Category Category1, Category2
Az.Network(이전에는 AzureRM.Network)
-
Get-AzServiceEndpointPolicyDefinition
cmdlet에서 사용되지 않는ResourceId
매개 변수 제거 -
PSVirtualNetwork
개체에서 사용되지 않는EnableVmProtection
속성 제거 - 사용되지 않는
Set-AzVirtualNetworkGatewayVpnClientConfig
cmdlet 제거됨
스크립트는 더 이상 이러한 필드의 값에 따라 처리를 결정하지 않아야 합니다.
Az.OperationalInsights(이전에는 AzureRM.OperationalInsights)
Get-AzOperationalInsightsDataSource
대한 기본 매개 변수 집합이 제거되고ByWorkspaceNameByKind
기본 매개 변수 집합이 되었습니다.를 사용하여 데이터 원본을 나열하는 스크립트
Get-AzureRmOperationalInsightsDataSource
종류를 지정하도록 변경해야 합니다.
Get-AzOperationalInsightsDataSource -Kind AzureActivityLog
Az.RecoveryServices(이전에는 AzureRM.RecoveryServices, AzureRM.RecoveryServices.Backup 및 AzureRM.RecoveryServices.SiteRecovery)
-
New/Set-AzRecoveryServicesAsrPolicy
cmdlet에서Encryption
매개 변수 제거됨 -
TargetStorageAccountName
매개 변수는 이제Restore-AzRecoveryServicesBackupItem
cmdlet의 관리 디스크 복원에 필수입니다. -
Restore-AzRecoveryServicesBackupItem
cmdlet에서StorageAccountName
및StorageAccountResourceGroupName
매개 변수 제거 -
Get-AzRecoveryServicesBackupContainer
cmdlet에서Name
매개 변수 제거됨
Az.Resources(이전에는 AzureRM.Resources)
New/Set-AzPolicyAssignment
cmdlet에서Sku
매개 변수 제거됨New-AzADServicePrincipal
및New-AzADSpCredential
cmdlet에서Password
매개 변수가 제거되었습니다. 암호는 자동으로 생성되며, 스크립트는 제공된 암호를 처리합니다.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)
- 다음 cmdlet 반환 형식이 변경되었습니다.
-
ApplicationHealthPolicy
형식의 속성ServiceTypeHealthPolicies
이 제거되었습니다. - 형식
ClusterUpgradeDeltaHealthPolicy
의 속성ApplicationHealthPolicies
이 제거되었습니다. - 형식
ClusterUpgradePolicy
의 속성OverrideUserUpgradePolicy
이(가) 제거되었습니다. - 이러한 변경 내용은 다음 cmdlet에 영향을 줍니다.
- 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)
-
Set-AzSqlDatabaseBackupLongTermRetentionPolicy
cmdlet에서State
및ResourceId
매개 변수 제거 - 제거된 사용되지 않는 cmdlet:
Get/Set-AzSqlServerBackupLongTermRetentionVault
,Get/Start/Stop-AzSqlServerUpgrade
,Get/Set-AzSqlDatabaseAuditingPolicy
,Get/Set-AzSqlServerAuditingPolicy
,Remove-AzSqlDatabaseAuditing
,Remove-AzSqlServerAuditing
-
Get-AzSqlDatabaseBackupLongTermRetentionPolicy
cmdlet에서 사용되지 않는 매개 변수Current
제거됨 -
Get-AzSqlServerServiceObjective
cmdlet에서 사용되지 않는 매개 변수DatabaseName
제거됨 -
Set-AzSqlDatabaseDataMaskingPolicy
cmdlet에서 사용되지 않는 매개 변수PrivilegedLogin
제거됨
Az.Storage(이전에는 Azure.Storage 및 AzureRM.Storage)
- Oauth 스토리지 컨텍스트를 스토리지 계정 이름만으로 지원하기 위해, 기본 매개 변수 집합이
OAuthParameterSet
으로 변경되었습니다.- 예:
$ctx = New-AzureStorageContext -StorageAccountName $accountName
- 예:
-
Get-AzStorageUsage
cmdlet에서Location
매개 변수가 필수가 되었습니다. - 이제 Storage API 메서드는 동기 API 호출 대신 TAP(작업 기반 비동기 패턴)을 사용합니다. 다음 예제에서는 새로운 비동기 명령을 보여 줍니다.
Blob 스냅샷
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
스냅샷 공유
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
일시 삭제된 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()
Blob 계층 설정
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
개체에서 사용되지 않는 속성이 제거되었습니다.
Azure PowerShell