Az 6.0.0 마이그레이션 가이드

이 문서에서는 5.0.0 및 6.0.0 버전의 Az 간의 변경 내용을 설명합니다.

• Az 6.0.0 대한 마이그레이션 가이드
  • 지원되는 PowerShell 버전
  • Az.Accounts
    • Connect-AzAccount
  • Az.ContainerInstance
    • New-AzContainerGroup
    • Remove-AzContainerGroup
    • Get-AzContainerGroup
    • Get-AzContainerInstanceLog
  • Az.DesktopVirtualization
    • New-AzWvdHostPool
    • Expand-AzWvdMsixImage
    • New-AzWvdMsixPackage
    • Update-AzWvdHostPool
  • Az.StreamAnalytics
    • Get-AzStreamAnalyticsDefaultFunctionDefinition
    • New-AzStreamAnalyticsJob
    • New-AzStreamAnalyticsTransformation
  • Az.RecoveryServices
    • Set-AzRecoveryServicesBackupProperty
    • Get-AzRecoveryServicesBackupJobDetail
  • Az.Storage
    • Remove-AzRmStorageShare
  • Az.ServiceFabric
    • Add-AzServiceFabricClusterCertificate
    • Get-AzServiceFabricManagedClusterService
    • New-AzServiceFabricManagedCluster
    • New-AzServiceFabricManagedClusterService
    • Remove-AzServiceFabricClusterCertificate
    • Remove-AzServiceFabricManagedClusterService
    • Set-AzServiceFabricManagedCluster
    • Set-AzServiceFabricManagedClusterService

지원되는 PowerShell 버전

CVE-2021-26701 Az 6은 다음 플랫폼에서만 지원됩니다.

• PowerShell 7.1: 버전 7.1.3 이상
• PowerShell 7.0: 버전 7.0.6 이상
• Windows PowerShell 5.1

자세한 내용은 Azure PowerShell 지원 수명 주기 참조하세요.

Az.Accounts

Connect-AzAccount

사용되지 않는 매개 변수 ManagedServiceHostName, ManagedServicePort 및 ManagedServiceSecret이 제거되었습니다.

전에

Connect-AzAccount -Identity -ManagedServiceSecret $secret

후

#To use customized MSI endpoint, please set environment variable MSI_ENDPOINT, e.g. "http://localhost:50342/oauth2/token"; to use customized MSI secret, please set environment variable MSI_SECRET.
Connect-AzAccount -Identity

Az.ContainerInstance

New-AzContainerGroup

더 이상 매개 변수 Image, RegistryCredential, AzureFileVolumeShareName, AzureFileVolumeAccountCredential, AzureFileVolumeMountPath, IdentityId, AssignIdentity, OsType, Cpu, MemoryInGB, IpAddressType, DnsNameLabel, Port, Command, EnvironmentVariable, RegistryServerDomain를 지원하지 않으며, 원래 매개 변수 이름에 대한 별칭도 찾을 수 없습니다.

전에

PS C:\> New-AzContainerGroup -ResourceGroupName demo -Name mycontainer -Image nginx -OsType Linux -IpAddressType Public -Port @(8000)

ResourceGroupName        : demo
Id                       : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/mycontainer
Name                     : mycontainer
Type                     : Microsoft.ContainerInstance/containerGroups
Location                 : westus
Tags                     :
ProvisioningState        : Creating
Containers               : {mycontainer}
ImageRegistryCredentials :
RestartPolicy            :
IpAddress                : 13.88.10.240
Ports                    : {8000}
OsType                   : Linux
Volumes                  :
State                    : Running
Events                   : {}

후

PS C:\> $port1 = New-AzContainerInstancePortObject -Port 8000 -Protocol TCP
PS C:\> $port2 = New-AzContainerInstancePortObject -Port 8001 -Protocol TCP
PS C:\> $container = New-AzContainerInstanceObject -Name test-container -Image nginx -RequestCpu 1 -RequestMemoryInGb 1.5 -Port @($port1, $port2)
PS C:\> $containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -OsType Linux -RestartPolicy "Never" -IpAddressType Public

Location Name    Type
-------- ----    ----
eastus   test-cg Microsoft.ContainerInstance/containerGroups

Remove-AzContainerGroup

'Remove-AzContainerGroup' cmdlet은 더 이상 'ResourceId' 매개 변수를 지원하지 않으며 원래 매개 변수 이름에 대한 별칭을 찾을 수 없습니다.

전에

PS C:\> Find-AzResource -ResourceGroupEquals MyResourceGroup -ResourceNameEquals MyContainer | Remove-AzContainerGroup

후

PS C:\> Remove-AzContainerGroup -Name test-cg -ResourceGroupName test-rg

Location Name    Type
-------- ----    ----
eastus   test-cg Microsoft.ContainerInstance/containerGroups

Get-AzContainerGroup

'Get-AzContainerGroup' cmdlet은 더 이상 'ResourceId' 매개 변수를 지원하지 않으며 원래 매개 변수 이름에 대한 별칭을 찾을 수 없습니다.

전에

PS C:\> Find-AzResource -ResourceGroupEquals demo -ResourceNameEquals mycontainer | Get-AzContainerGroup

ResourceGroupName        : demo
Id                       : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/mycontainer
Name                     : mycontainer
Type                     : Microsoft.ContainerInstance/containerGroups
Location                 : westus
Tags                     :
ProvisioningState        : Succeeded
Containers               : {mycontainer}
ImageRegistryCredentials :
RestartPolicy            :
IpAddress                : 13.88.10.240
Ports                    : {8000}
OsType                   : Linux
Volumes                  :
State                    : Running
Events                   : {}

후

PS C:\> Get-AzContainerGroup

Location Name           Type
-------- ----           ----
eastus   bez-cg1         Microsoft.ContainerInstance/containerGroups
eastus   bez-cg2        Microsoft.ContainerInstance/containerGroups

Get-AzContainerInstanceLog

'Get-AzContainerInstanceLog' cmdlet은 더 이상 'ResourceId' 매개 변수를 지원하지 않으며 원래 매개 변수 이름에 대한 별칭을 찾을 수 없습니다. 'Get-AzContainerInstanceLog' cmdlet은 더 이상 'Name' 매개 변수를 지원하지 않으며 원래 매개 변수 이름에 대한 별칭을 찾을 수 없습니다.

전에

PS C:\> Get-AzContainerGroup -ResourceGroupName demo -Name mycontainer | Get-AzContainerInstanceLog

Log line 1.
Log line 2.
Log line 3.
Log line 4.

후

PS C:\> Get-AzContainerInstanceLog -ContainerGroupName test-cg -ContainerName test-container -ResourceGroupName test-rg

Az.DesktopVirtualization

New-AzWvdHostPool

'New-AzWvdHostPool' cmdlet은 더 이상 'SsoContext' 매개 변수를 지원하지 않으며 원래 매개 변수 이름에 대한 별칭을 찾을 수 없습니다.

Expand-AzWvdMsixImage

'Expand-AzWvdMsixImage' cmdlet은 더 이상 'MsixImageUri' 매개 변수에 대해 'Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixImageUri' 형식을 지원하지 않습니다.

전에

$MsixImageUri = [Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixImageUri]::New()
Get-AzWvdDesktop -ResourceGroupName ResourceGroupName -ApplicationGroupName ApplicationGroupName -Name DesktopName | Expand-AzWvdMsixImage -MsixImageUri $MsixImageUri

후

$MsixImageUri = [Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20210201Preview.IMsixImageUri]::New()
Get-AzWvdDesktop -ResourceGroupName ResourceGroupName -ApplicationGroupName ApplicationGroupName -Name DesktopName | Expand-AzWvdMsixImage -MsixImageUri $MsixImageUri

New-AzWvdMsixPackage

'PackageApplication' 매개 변수의 요소 형식이 'Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixPackageApplications'에서 'Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20210201Preview.IMsixPackageApplications'로 변경되었습니다. 'PackageDependency' 매개 변수의 요소 형식이 'Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixPackageDependencies'에서 'Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20210201Preview.IMsixPackageDependencies'로 변경되었습니다.

전에

PS C:\> $apps = @([Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixPackageApplications]::New())
PS C:\> $deps = @([Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixPackageDependencies]::New())
PS C:\> New-AzWvdMsixPackage -FullName PackageFullName `
							-HostPoolName HostPoolName `
							-ResourceGroupName ResourceGroupName `
							-SubscriptionId SubscriptionId `
							-DisplayName displayname `
							-ImagePath imageURI `
							-IsActive:$false `
							-IsRegularRegistration:$false `
							-LastUpdated datelastupdated `
							-PackageApplication $apps `
							-PackageDependency $deps `
							-PackageFamilyName packagefamilyname `
							-PackageName packagename `
							-PackageRelativePath packagerelativepath `
							-Version packageversion `

후

PS C:\> $apps = @([Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20210201Preview.IMsixPackageApplications]::New())
PS C:\> $deps = @([Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20210201Preview.IMsixPackageDependencies]::New())
PS C:\> New-AzWvdMsixPackage -FullName PackageFullName `
							-HostPoolName HostPoolName `
							-ResourceGroupName ResourceGroupName `
							-SubscriptionId SubscriptionId `
							-DisplayName displayname `
							-ImagePath imageURI `
							-IsActive:$false `
							-IsRegularRegistration:$false `
							-LastUpdated datelastupdated `
							-PackageApplication $apps `
							-PackageDependency $deps `
							-PackageFamilyName packagefamilyname `
							-PackageName packagename `
							-PackageRelativePath packagerelativepath `
							-Version packageversion `

Update-AzWvdHostPool

'Update-AzWvdHostPool' cmdlet은 더 이상 'SsoContext' 매개 변수를 지원하지 않으며 원래 매개 변수 이름에 대한 별칭을 찾을 수 없습니다.

Az.StreamAnalytics

Get-AzStreamAnalyticsDefaultFunctionDefinition

'Get-AzStreamAnalyticsDefaultFunctionDefinition' cmdlet은 더 이상 'File' 매개 변수를 지원하지 않으며 원래 매개 변수 이름에 대한 별칭을 찾을 수 없습니다.

전에

Get-AzStreamAnalyticsDefaultFunctionDefinition -ResourceGroupName "StreamAnalytics-Default-West-US" -JobName "StreamJob22" -File "C:\RetrieveDefaultDefinitionRequest.json" -Name "ScoreTweet"

후

Get-AzStreamAnalyticsDefaultFunctionDefinition -ResourceGroupName azure-rg-test -JobName sajob-01-pwsh -Name mlsfunction-01 -BindingType Microsoft.MachineLearningServices -Endpoint "http://875da830-4d5f-44f1-b221-718a5f26a21d.eastus.azurecontainer.io/score"-UdfType Scalar
Input is specified in flattened parameters instead from the input file.

New-AzStreamAnalyticsJob

'New-AzStreamAnalyticsJob' cmdlet은 더 이상 'File' 매개 변수를 지원하지 않으며 원래 매개 변수 이름에 대한 별칭을 찾을 수 없습니다.

전에

New-AzStreamAnalyticsJob -ResourceGroupName "StreamAnalytics-Default-West-US" -File "C:\JobDefinition.json"

후

New-AzStreamAnalyticsJob -ResourceGroupName azure-rg-test -Name sajob-02-pwsh -Location westcentralus -SkuName Standard
Input is specified in flattened parameters instead from the input file.

New-AzStreamAnalyticsTransformation

'New-AzStreamAnalyticsTransformation' cmdlet은 더 이상 'File' 매개 변수를 지원하지 않으며 원래 매개 변수 이름에 대한 별칭을 찾을 수 없습니다.

전에

New-AzStreamAnalyticsTransformation -ResourceGroupName "StreamAnalytics-Default-West-US" -File "C:\Transformation.json" -JobName "StreamingJob" -Name "StreamingJobTransform"

후

New-AzStreamAnalyticsTransformation -ResourceGroupName azure-rg-test -JobName sajob-01-pwsh -Name tranf-01 -StreamingUnit 6 -Query "Select Id, Name from input-01"
Input is specified in flattened parameters instead from the input file.

Az.RecoveryServices

Set-AzRecoveryServicesBackupProperty

복수 별칭 Set-AzRecoveryServicesBackupProperties를 제거하고 앞으로는 Set-AzRecoveryServicesBackupProperty cmdlet 이름을 사용합니다.

Get-AzRecoveryServicesBackupJobDetail

Get-AzRecoveryServicesBackupJobDetails 복수 별칭을 제거하고 앞으로 Get-AzRecoveryServicesBackupJobDetail cmdlet 이름을 사용합니다.

전에

$jobDetails = Get-AzRecoveryServicesBackupJobDetails -VaultId $vault.ID -Job $job
$jobDetails2 = Get-AzRecoveryServicesBackupJobDetails -VaultId $vault.ID -JobId $job.JobId

후

$jobDetails = Get-AzRecoveryServicesBackupJobDetail -VaultId $vault.ID -Job $job
$jobDetails2 = Get-AzRecoveryServicesBackupJobDetail -VaultId $vault.ID -JobId $job.JobId

Az.Storage

Remove-AzRmStorageShare

'Remove-AzRmStorageShare' cmdlet은 이전까지 기본적으로 스냅샷과 함께 공유를 제거할 수 있었지만, 변경 후에는 기본적으로 스냅샷과 함께 공유를 제거하는 것이 실패하게 됩니다. 이때 성공적으로 제거하기 위해서는 "-Include Snapshots" 매개 변수를 추가해야 합니다.

전에

Remove-AzRmStorageShare -ResourceGroupName $resourceGroupName -StorageAccountName $accountName -Name $shareName

후

Remove-AzRmStorageShare -ResourceGroupName $resourceGroupName -StorageAccountName $accountName -Name $shareName -Force -Include Snapshots

Az.ServiceFabric

Add-AzServiceFabricClusterCertificate

이 cmdlet은 완전히 제거되었습니다. 여기에 지침에 따라 클러스터 인증서를 추가하세요.

Get-AzServiceFabricManagedClusterService

sdk에서 직접 속성 매개 변수를 사용하지 않도록 PSManagedService 모델을 변경합니다. 이제 모든 속성이 개체의 첫 번째 수준에 있습니다. 그리고 사용되지 않는 매개 변수 InstanceCloseDelayDuration, DropSourceReplicaOnMove 및 ServiceDnsName을 제거합니다.

전에

$service = Get-AzServiceFabricManagedClusterService -ResourceId $resourceId
$statelessService.Properties.ProvisioningState

후

$service = Get-AzServiceFabricManagedClusterService -ResourceId $resourceId
$statelessService.ProvisioningState

New-AzServiceFabricManagedCluster

사용되지 않는 매개 변수 ReverseProxyEndpointPort를 제거합니다.

New-AzServiceFabricManagedClusterService

sdk에서 직접 속성 매개 변수를 사용하지 않도록 PSManagedService 모델을 변경합니다. 이제 모든 속성이 개체의 첫 번째 수준에 있습니다. 그리고 사용되지 않는 매개 변수 InstanceCloseDelayDuration, DropSourceReplicaOnMove 및 ServiceDnsName을 제거합니다.

전에

$service = New-AzServiceFabricManagedClusterService -ResourceGroupName $resourceGroupName -ClusterName $clusterName -ApplicationName $appName -Name $serviceName -Type $serviceTypeName -Stateless -InstanceCount -1 -PartitionSchemaSingleton
$statelessService.Properties.ProvisioningState

후

$service = New-AzServiceFabricManagedClusterService -ResourceGroupName $resourceGroupName -ClusterName $clusterName -ApplicationName $appName -Name $serviceName -Type $serviceTypeName -Stateless -InstanceCount -1 -PartitionSchemaSingleton
$statelessService.ProvisioningState

Remove-AzServiceFabricClusterCertificate

이 cmdlet은 완전히 제거되었습니다. 여기에 지침에 따라 클러스터 인증서를 추가하세요.

Remove-AzServiceFabricManagedClusterService

sdk에서 직접 속성 매개 변수를 사용하지 않도록 PSManagedService 모델을 변경합니다. 이제 모든 속성이 개체의 첫 번째 수준에 있습니다.

Set-AzServiceFabricManagedCluster

사용되지 않는 매개 변수 ReverseProxyEndpointPort를 제거합니다.

Set-AzServiceFabricManagedClusterService

sdk에서 직접 속성 매개 변수를 사용하지 않도록 PSManagedService 모델을 변경합니다. 이제 모든 속성이 개체의 첫 번째 수준에 있습니다. 그리고 사용되지 않는 매개 변수 InstanceCloseDelayDuration, DropSourceReplicaOnMove 및 ServiceDnsName을 제거합니다.

전에

$service = Get-AzServiceFabricManagedClusterService -ResourceId $resourceId
$statelessService.Properties.MinInstanceCount = 3
service | Set-AzServiceFabricManagedClusterService

후에

$service = Get-AzServiceFabricManagedClusterService -ResourceId $resourceId
$statelessService.MinInstanceCount = 3
service | Set-AzServiceFabricManagedClusterService