Copy-SimanAzDatabase⚓︎

SYNOPSIS⚓︎

Crea una copia de una base de datos en Azure SQL.

Importante

Se necesita el rol de Cloud Admin para ejecutar este comando.

SYNTAX⚓︎

Copy-SimanAzDatabase [-DatabaseName] <String> [-CopyDatabaseName] <String> [-ServerName <String>]
 [-CopyServerName <String>] [-ServiceObjective <String>] [-Tags <Hashtable>] [<CommonParameters>]

DESCRIPTION⚓︎

Genera una copia de una base de datos en Azure SQL hacia cualquier servidor de la plataforma.
Si se realiza una copia dentro del mismo servidor y la base de datos origen está en un grupo elástico, la copia quedara en el mismo grupo si no se especifica un ServiceObjective.

La función automáticamente añade las siguientes etiquetas a la base de datos copiada:
Environment: Testing (si no se especifica en los Tags)
CopyDate: Fecha y hora de la copia en formato yyyy-MM-dd HH:mm

EXAMPLES⚓︎

Example 1 - Copia una base de datos al servidor de pruebas⚓︎

PS> Copy-SimanAzDatabase -DatabaseName 'SUS102_SDM' -CopyDatabaseName 'SUS102_SDM_BACKUP'

DatabaseName     : SUS102_SDM_BACKUP
ServerName       : siman-test-std
CopyDate         : 2025-04-24 14:20
Tags             : {[Role, DATA], [Group, G8-DB], [Subscriber, SUS102], [Environment, Testing]}
ServiceObjective : S0

Example 2 - Copia una base de datos a otro servidor con distinto nivel de servicio⚓︎

PS> Copy-SimanAzDatabase -DatabaseName 'SUS102_SDM' -CopyDatabaseName 'SUS102_SDM-DWH' -CopyServerName 'siman-prod-dwh' -ServiceObjective 'S3' -Tags @{ Environment = 'Development' }

DatabaseName     : SUS102_SDM-DWH
ServerName       : siman-prod-dwh
CopyDate         : 2025-04-24 14:44
Tags             : {[Role, DATA], [Group, G8-DB], [Subscriber, SUS102], [Environment, Development]}
ServiceObjective : S3

PARAMETERS⚓︎

-DatabaseName⚓︎

Nombre de la base de datos origen en Azure SQL que se desea copiar.

Type: System.String
Parameter Sets: (All)
Aliases: Name

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CopyDatabaseName⚓︎

Nombre que se asignará a la nueva copia de la base de datos.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ServerName⚓︎

Nombre del servidor Azure SQL donde se encuentra la base de datos origen.
Si no se especifica, se usa siman-prod-std.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: siman-prod-std
Accept pipeline input: False
Accept wildcard characters: False

-CopyServerName⚓︎

Nombre del servidor Azure SQL donde se creará la copia.
Si no se especifica, se usa el servidor de pruebas configurado siman-test-std.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ServiceObjective⚓︎

Capacidad que se asignará a la nueva base de datos.
Si no se especifica y la base de datos origen está en un Elastic Pool, la copia quedara en el mismo pool o en caso contrario se le asignara la misma capacidad de la base de datos original.

Valores permitidos: S0 | S1 | S2 | S3 | S4 | S6
Azure SQL Standard Service Tiers

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Tags⚓︎

Etiquetas adicionales para asignar a la copia de la base de datos. Se combinarán con las etiquetas de la base de datos origen.

Type: System.Collections.Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters⚓︎

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