Get-AzSqlInstanceDatabaseCopyOperation

Module:

Az.Sql Module

Get managed database copy operation details

Syntax

GetMoveCopyManagedDatabaseOperationsByNameParameterSet (Default)

Get-AzSqlInstanceDatabaseCopyOperation
    [-InstanceName] <String>
    [-ResourceGroupName] <String>
    [-DatabaseName <String>]
    [-TargetResourceGroupName <String>]
    [-TargetInstanceName <String>]
    [-OnlyLatestPerDatabase]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetMoveCopyManagedDatabaseOperationsByInputObjectParameterSet

Get-AzSqlInstanceDatabaseCopyOperation
    [-InstanceName] <String>
    [-ResourceGroupName] <String>
    -DatabaseObject <AzureSqlManagedDatabaseModel>
    [-DatabaseName <String>]
    [-TargetResourceGroupName <String>]
    [-TargetInstanceName <String>]
    [-OnlyLatestPerDatabase]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetMoveCopyManagedDatabaseOperationsByMoveCopyObjectParameterSet

Get-AzSqlInstanceDatabaseCopyOperation
    [-InstanceName] <String>
    [-ResourceGroupName] <String>
    -ModelObject <MoveCopyManagedDatabaseModel>
    [-DatabaseName <String>]
    [-TargetResourceGroupName <String>]
    [-TargetInstanceName <String>]
    [-OnlyLatestPerDatabase]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetMoveCopyManagedDatabaseOperationsByResourceIdParameterSet

Get-AzSqlInstanceDatabaseCopyOperation
    [-InstanceName] <String>
    [-ResourceGroupName] <String>
    -ResourceId <String>
    [-TargetResourceGroupName <String>]
    [-TargetInstanceName <String>]
    [-OnlyLatestPerDatabase]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

The Get-AzSqlInstanceDatabaseCopyOperation cmdlet get copy managed database operation details.

Examples

Example 1: Get all copy operation on single Azure SQL Managed Instance

Get-AzSqlInstanceDatabaseCopyOperation -ResourceGroupName RG1 -InstanceName instance1

Name                      : 11111111-1111-1111-1111-111111111111
Id                        : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG1/providers/Microso
                            ft.Sql/locations/westcentralus/managedDatabaseMoveOperationResults/11111111-1111-1111-1111-111111111111
Operation                 : StartCrossManagedInstanceDatabaseMovement
OperationFriendlyName     : Start Azure SQL Managed Instance database copy
StartTime                 : 5/30/2023 10:11:21 AM
State                     : Succeeded
OperationMode             : Copy
SourceManagedInstanceName : instance1
TargetManagedInstanceName : instance2
SourceManagedInstanceId   : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG1/providers/Microso
                            ft.Sql/managedInstances/instance1
TargetManagedInstanceId   : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG1/providers/Microsoft.Sql/managedInstances/instance2
SourceDatabaseName        : db1
TargetDatabaseName        : db1
IsCancellable             : True
ErrorCode                 :
ErrorDescription          :
ErrorSeverity             :
IsUserError               :

Name                      : 22222222-2222-2222-2222-222222222222
Id                        : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG1/providers/Microso
                            ft.Sql/locations/westcentralus/managedDatabaseMoveOperationResults/22222222-2222-2222-2222-222222222222
Operation                 : StartCrossManagedInstanceDatabaseMovement
OperationFriendlyName     : Start Azure SQL Managed Instance database copy
StartTime                 : 5/30/2023 10:11:21 AM
State                     : Succeeded
OperationMode             : Copy
SourceManagedInstanceName : instance1
TargetManagedInstanceName : instance3
SourceManagedInstanceId   : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG1/providers/Microso
                            ft.Sql/managedInstances/instance1
TargetManagedInstanceId   : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG1/providers/Microsoft.Sql/managedInstances/instance3
SourceDatabaseName        : db2
TargetDatabaseName        : db2
IsCancellable             : True
ErrorCode                 :
ErrorDescription          :
ErrorSeverity             :
IsUserError               :

Name                      : 33333333-3333-3333-3333-333333333333
Id                        : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG1/providers/Microso
                            ft.Sql/locations/westcentralus/managedDatabaseMoveOperationResults/33333333-3333-3333-3333-333333333333
Operation                 : CancelCrossManagedInstanceDatabaseMovement
OperationFriendlyName     : Cancel Azure SQL Managed Instance database copy
StartTime                 : 5/30/2023 11:11:21 AM
State                     : Succeeded
OperationMode             : Copy
SourceManagedInstanceName : instance1
TargetManagedInstanceName : instance3
SourceManagedInstanceId   : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG1/providers/Microso
                            ft.Sql/managedInstances/instance1
TargetManagedInstanceId   : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG1/providers/Microsoft.Sql/managedInstances/instance3
SourceDatabaseName        : db2
TargetDatabaseName        : db2
IsCancellable             : False
ErrorCode                 :
ErrorDescription          :
ErrorSeverity             :
IsUserError               :

This command will return all copy operations for instance instance1 in resource group RG1.

Example 2: Get all copy operations on Azure SQL Managed Instance for one database

Get-AzSqlInstanceDatabaseCopyOperation -ResourceGroupName RG1 -InstanceName instance1 -DatabaseName db2

Name                      : 22222222-2222-2222-2222-222222222222
Id                        : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG1/providers/Microso
                            ft.Sql/locations/westcentralus/managedDatabaseMoveOperationResults/22222222-2222-2222-2222-222222222222
Operation                 : StartCrossManagedInstanceDatabaseMovement
OperationFriendlyName     : Start Azure SQL Managed Instance database copy
StartTime                 : 5/30/2023 10:11:21 AM
State                     : Succeeded
OperationMode             : Copy
SourceManagedInstanceName : instance1
TargetManagedInstanceName : instance3
SourceManagedInstanceId   : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG1/providers/Microso
                            ft.Sql/managedInstances/instance1
TargetManagedInstanceId   : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG1/providers/Microsoft.Sql/managedInstances/instance3
SourceDatabaseName        : db2
TargetDatabaseName        : db2
IsCancellable             : True
ErrorCode                 :
ErrorDescription          :
ErrorSeverity             :
IsUserError               :


Name                      : 33333333-3333-3333-3333-333333333333
Id                        : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG1/providers/Microso
                            ft.Sql/locations/westcentralus/managedDatabaseMoveOperationResults/33333333-3333-3333-3333-333333333333
Operation                 : CancelCrossManagedInstanceDatabaseMovement
OperationFriendlyName     : Cancel Azure SQL Managed Instance database copy
StartTime                 : 5/30/2023 11:11:21 AM
State                     : Succeeded
OperationMode             : Copy
SourceManagedInstanceName : instance1
TargetManagedInstanceName : instance3
SourceManagedInstanceId   : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG1/providers/Microso
                            ft.Sql/managedInstances/instance1
TargetManagedInstanceId   : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG1/providers/Microsoft.Sql/managedInstances/instance3
SourceDatabaseName        : db2
TargetDatabaseName        : db2
IsCancellable             : False
ErrorCode                 :
ErrorDescription          :
ErrorSeverity             :
IsUserError               :

This command will return all copy operations for database db2 on instance instance1 in resource group RG1.

Example 3: Get only latest copy operation on Azure SQL Managed Instance for one database

Get-AzSqlInstanceDatabaseCopyOperation -ResourceGroupName RG1 -InstanceName instance1 -DatabaseName db2 -OnlyLatestPerDatabase

Name                      : 33333333-3333-3333-3333-333333333333
Id                        : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG1/providers/Microso
                            ft.Sql/locations/westcentralus/managedDatabaseMoveOperationResults/33333333-3333-3333-3333-333333333333
Operation                 : CancelCrossManagedInstanceDatabaseMovement
OperationFriendlyName     : Cancel Azure SQL Managed Instance database copy
StartTime                 : 5/30/2023 11:11:21 AM
State                     : Succeeded
OperationMode             : Copy
SourceManagedInstanceName : instance1
TargetManagedInstanceName : instance3
SourceManagedInstanceId   : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG1/providers/Microso
                            ft.Sql/managedInstances/instance1
TargetManagedInstanceId   : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG1/providers/Microsoft.Sql/managedInstances/instance3
SourceDatabaseName        : db2
TargetDatabaseName        : db2
IsCancellable             : False
ErrorCode                 :
ErrorDescription          :
ErrorSeverity             :
IsUserError               :

This command will return latest copy operation for database db2 on instance instance1 in resource group RG1.

Parameters

-DatabaseName

Name of a database on Azure SQL Managed Instance.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False
Aliases:	Name

Parameter sets

GetMoveCopyManagedDatabaseOperationsByNameParameterSet

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-DatabaseObject

Managed database object.

Parameter properties

Type:	AzureSqlManagedDatabaseModel
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

GetMoveCopyManagedDatabaseOperationsByInputObjectParameterSet

Position:	Named
Mandatory:	True
Value from pipeline:	True
Value from pipeline by property name:	False
Value from remaining arguments:	False

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with Azure.

Parameter properties

Type:	IAzureContextContainer
Default value:	None
Supports wildcards:	False
DontShow:	False
Aliases:	AzContext, AzureRmContext, AzureCredential

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-InstanceName

The name of the instance.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	1
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	True
Value from remaining arguments:	False

-ModelObject

Object that is returned from start move or copy operation using -PassThru parameter.

Parameter properties

Type:	MoveCopyManagedDatabaseModel
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

GetMoveCopyManagedDatabaseOperationsByMoveCopyObjectParameterSet

Position:	Named
Mandatory:	True
Value from pipeline:	True
Value from pipeline by property name:	False
Value from remaining arguments:	False

-OnlyLatestPerDatabase

Return only latest opereation per managed database

Parameter properties

Type:	SwitchParameter
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-ResourceGroupName

The name of the resource group.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	0
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	True
Value from remaining arguments:	False

-ResourceId

Resource id of managed database.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

GetMoveCopyManagedDatabaseOperationsByResourceIdParameterSet

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	True
Value from remaining arguments:	False

-TargetInstanceName

Name of the target Azure SQL Managed Instance.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

GetMoveCopyManagedDatabaseOperationsByNameParameterSet

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetMoveCopyManagedDatabaseOperationsByInputObjectParameterSet

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetMoveCopyManagedDatabaseOperationsByResourceIdParameterSet

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-TargetResourceGroupName

Name of the target resource group.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

GetMoveCopyManagedDatabaseOperationsByNameParameterSet

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetMoveCopyManagedDatabaseOperationsByInputObjectParameterSet

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetMoveCopyManagedDatabaseOperationsByResourceIdParameterSet

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

String

AzureSqlManagedDatabaseModel

MoveCopyManagedDatabaseModel

Outputs

ManagedDatabaseMoveCopyOperation

Related Links

• Complete-AzSqlInstanceDatabaseCopy
• Stop-AzSqlInstanceDatabaseCopy
• Copy-AzSqlInstanceDatabase
• Get-AzSqlInstanceDatabaseMoveOperation