Compartilhar via

New-AzSqlDatabaseCopy

  • Referência
Módulo:
Az.Sql

Cria uma cópia de um Banco de Dados SQL que usa o instantâneo no momento atual.

Sintaxe

New-AzSqlDatabaseCopy
   [-DatabaseName] <String>
   [-ServiceObjectiveName <String>]
   [-ElasticPoolName <String>]
   [-Tags <Hashtable>]
   [-CopyResourceGroupName <String>]
   [-CopyServerName <String>]
   -CopyDatabaseName <String>
   [-AsJob]
   [-LicenseType <String>]
   [-BackupStorageRedundancy <String>]
   [-ZoneRedundant]
   [-AssignIdentity]
   [-EncryptionProtector <String>]
   [-UserAssignedIdentityId <String[]>]
   [-KeyList <String[]>]
   [-FederatedClientId <Guid>]
   [-EncryptionProtectorAutoRotation]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzSqlDatabaseCopy
   [-DatabaseName] <String>
   [-Tags <Hashtable>]
   [-CopyResourceGroupName <String>]
   [-CopyServerName <String>]
   -CopyDatabaseName <String>
   [-AsJob]
   -ComputeGeneration <String>
   -VCore <Int32>
   [-LicenseType <String>]
   [-BackupStorageRedundancy <String>]
   [-ZoneRedundant]
   [-AssignIdentity]
   [-EncryptionProtector <String>]
   [-UserAssignedIdentityId <String[]>]
   [-KeyList <String[]>]
   [-FederatedClientId <Guid>]
   [-EncryptionProtectorAutoRotation]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-AzSqlDatabaseCopy cria uma cópia de um Banco de Dados SQL do Azure que usa o instantâneo dos dados no momento atual. Use esse cmdlet em vez do cmdlet Start-AzSqlDatabaseCopy para criar uma cópia única do banco de dados. Esse cmdlet retorna o objeto Database da cópia. Observação: use o cmdlet New-AzSqlDatabaseSecondary para configurar a replicação geográfica para um banco de dados. O serviço de SQL Server Stretch Database no Azure também dá suporte a esse cmdlet.

Exemplos

Exemplo 1

Cria uma cópia de um Banco de Dados SQL que usa o instantâneo no momento atual. (gerado automaticamente)

New-AzSqlDatabaseCopy -CopyDatabaseName <String> -CopyResourceGroupName <String> -CopyServerName <String> -DatabaseName db1 -ResourceGroupName MyResourceGroup -ServerName s1

Exemplo 2

Cria uma cópia de um Banco de Dados SQL que usa o instantâneo no momento atual. (gerado automaticamente)

New-AzSqlDatabaseCopy -CopyDatabaseName <String> -CopyResourceGroupName <String> -CopyServerName <String> -DatabaseName db1 -ResourceGroupName MyResourceGroup -ServerName s1 -ServiceObjectiveName 'S1'

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AssignIdentity

Gere e atribua uma identidade do Microsoft Entra para esse banco de dados para uso com serviços de gerenciamento de chaves, como o Azure KeyVault.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-BackupStorageRedundancy

A redundância de armazenamento de backup usada para armazenar backups para o Banco de Dados SQL. As opções são: Local, Zona e Geo.

Tipo:String
Valores aceitos:Local, Zone, Geo, GeoZone
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ComputeGeneration

A geração de computação a ser atribuída à nova cópia.

Tipo:String
Aliases:Family
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CopyDatabaseName

Especifica o nome da cópia do Banco de Dados SQL.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CopyResourceGroupName

Especifica o nome do Grupo de Recursos do Azure no qual atribuir a cópia.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CopyServerName

Especifica o nome do SQL Server que hospeda a cópia.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DatabaseName

Especifica o nome do Banco de Dados SQL a ser copiado.

Tipo:String
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usadas para comunicação com o Azure

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ElasticPoolName

Especifica o nome do pool elástico no qual atribuir a cópia.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EncryptionProtector

A chave do protetor de criptografia para cópia do Banco de Dados SQL.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EncryptionProtectorAutoRotation

O status da rotação automática da chave AKV

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-FederatedClientId

A ID do cliente federado para o Banco de Dados SQL. Ele é usado para o cenário CMK entre locatários.

Tipo:Nullable<T>[Guid]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-KeyList

A lista de chaves AKV para a cópia do Banco de Dados SQL.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LicenseType

O tipo de licença para o banco de dados SQL do Azure.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceGroupName

Especifica o nome do Grupo de Recursos que contém o banco de dados a ser copiado.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ServerName

Especifica o nome do SQL Server que contém o banco de dados a ser copiado.

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ServiceObjectiveName

Especifica o nome do objetivo de serviço a ser atribuído à cópia.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Tags

Especifica os pares de chave-valor na forma de uma tabela de hash a ser associada à cópia do Banco de Dados SQL do Azure. Por exemplo: @{key0="value0"; chave1=$null; chave2="valor2"}

Tipo:Hashtable
Aliases:Tag
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UserAssignedIdentityId

A lista de identidades atribuídas pelo usuário para a cópia do Banco de Dados SQL.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VCore

Os números Vcore da cópia do Banco de Dados SQL do Azure.

Tipo:Int32
Aliases:Capacity
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ZoneRedundant

A redundância de zona a ser associada ao Banco de Dados SQL do Azure. Essa propriedade só pode ser definida para bancos de dados de edição de Hiperescala.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

Saídas

AzureSqlDatabaseCopyModel