Поделиться через

New-AzSqlDatabaseSecondary

Модуль:
Az.Sql Module

Создает вторичную базу данных для существующей базы данных и начинает репликацию данных.

Синтаксис

DtuBasedDatabase (по умолчанию) 

New-AzSqlDatabaseSecondary
    [-DatabaseName] <String>
    [-ServerName] <String>
    [-ResourceGroupName] <String>
    -PartnerResourceGroupName <String>
    -PartnerServerName <String>
    [-SecondaryServiceObjectiveName <String>]
    [-SecondaryElasticPoolName <String>]
    [-Tags <Hashtable>]
    [-PartnerDatabaseName <String>]
    [-AllowConnections <AllowConnections>]
    [-AsJob]
    [-LicenseType <String>]
    [-BackupStorageRedundancy <String>]
    [-SecondaryType <String>]
    [-HighAvailabilityReplicaCount <Int32>]
    [-ZoneRedundant]
    [-AssignIdentity]
    [-EncryptionProtector <String>]
    [-UserAssignedIdentityId <String[]>]
    [-KeyList <String[]>]
    [-FederatedClientId <Guid>]
    [-EncryptionProtectorAutoRotation]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

VcoreBasedDatabase 

New-AzSqlDatabaseSecondary
    [-DatabaseName] <String>
    [-ServerName] <String>
    [-ResourceGroupName] <String>
    -PartnerResourceGroupName <String>
    -PartnerServerName <String>
    -SecondaryComputeGeneration <String>
    -SecondaryVCore <Int32>
    [-Tags <Hashtable>]
    [-PartnerDatabaseName <String>]
    [-AllowConnections <AllowConnections>]
    [-AsJob]
    [-SecondaryComputeModel <String>]
    [-LicenseType <String>]
    [-AutoPauseDelayInMinutes <Int32>]
    [-MinimumCapacity <Double>]
    [-BackupStorageRedundancy <String>]
    [-SecondaryType <String>]
    [-HighAvailabilityReplicaCount <Int32>]
    [-ZoneRedundant]
    [-AssignIdentity]
    [-EncryptionProtector <String>]
    [-UserAssignedIdentityId <String[]>]
    [-KeyList <String[]>]
    [-FederatedClientId <Guid>]
    [-EncryptionProtectorAutoRotation]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Командлет New-AzSqlDatabaseSecondary заменяет командлет Start-AzSqlDatabaseCopy при настройке георепликации для базы данных. Он возвращает объект связи георепликации из первичной базы данных в базу данных-получатель.

Примеры

Пример 1. Установка активной георепликации

$database = Get-AzSqlDatabase -DatabaseName $databasename -ResourceGroupName $primaryresourcegroupname -ServerName $primaryservername
$database | New-AzSqlDatabaseSecondary -PartnerResourceGroupName $secondaryresourcegroupname -PartnerServerName $secondaryservername -AllowConnections "All"

Пример 2. Установите активную георепликацию и укажите имя базы данных партнера, отличное от имени исходной базы данных.

$database = Get-AzSqlDatabase -DatabaseName $databasename -ResourceGroupName $primaryresourcegroupname -ServerName $primaryservername
$database | New-AzSqlDatabaseSecondary -PartnerResourceGroupName $secondaryresourcegroupname -PartnerServerName $secondaryservername -PartnerDatabaseName $secondarydatabasename -AllowConnections "All"

Параметры

-AllowConnections

Указывает намерение чтения вторичного База данных SQL Azure. Допустимые значения для этого параметра:

  • нет
  • Все

Свойства параметра

Тип:AllowConnections
Default value:None
Допустимые значения:No, All
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AsJob

Запуск командлета в фоновом режиме

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AssignIdentity

Создайте и назначьте удостоверение Microsoft Entra для этой базы данных для использования со службами управления ключами, такими как Azure KeyVault.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AutoPauseDelayInMinutes

Автоматическая приостановка задержки в минутах для базы данных (только без сервера), -1, чтобы отказаться от использования

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-BackupStorageRedundancy

Избыточность хранилища резервных копий, используемая для хранения резервных копий для База данных SQL. Варианты: локальные, зоны и географическое расположение.

Свойства параметра

Тип:String
Default value:None
Допустимые значения:Local, Zone, Geo, GeoZone
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DatabaseName

Указывает имя базы данных, выступающая в качестве первичной.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:2
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure

Свойства параметра

Тип:IAzureContextContainer
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-EncryptionProtector

Ключ защиты шифрования для копирования База данных SQL.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-EncryptionProtectorAutoRotation

Состояние автоматического поворота ключа AKV

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-FederatedClientId

Федеративный идентификатор клиента для базы данных SQL. Он используется для сценария CMK между клиентами.

Свойства параметра

Тип:

Nullable<T>[Guid]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-HighAvailabilityReplicaCount

Количество вторичных реплик чтения, связанных с базой данных, к которой могут направляться подключения намерения приложения для чтения. Это свойство доступно только для баз данных гипермасштабирования.

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-KeyList

Список ключей AKV для копии База данных SQL.

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-LicenseType

Тип лицензии для базы данных Sql Azure.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-MinimumCapacity

Минимальная емкость, выделенная базой данных-получателем, если она не приостановлена. Только для бессерверных баз данных Sql Azure.

Свойства параметра

Тип:Double
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:MinVCore, MinCapacity

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PartnerDatabaseName

Имя создаваемой базы данных-получателя.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PartnerResourceGroupName

Указывает имя группы ресурсов Azure, которой этот командлет назначает базу данных-получатель.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PartnerServerName

Указывает имя сервера базы данных SQL Azure, который будет выступать в качестве вторичного.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PartnerSubscriptionId

Указывает подписку сервера базы данных SQL Azure, если она отличается от источника.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ResourceGroupName

Указывает имя группы ресурсов Azure, которой этот командлет назначает базу данных-источник.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-SecondaryComputeGeneration

Создание вычислительных ресурсов вторичной базы данных SQL Azure.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Семья

Наборы параметров

VcoreBasedDatabase
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SecondaryComputeModel

Модель вычислений для вторичной базы данных Sql Azure. Бессерверные или подготовленные

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

VcoreBasedDatabase
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SecondaryElasticPoolName

Указывает имя эластичного пула, в котором следует поместить базу данных-получатель.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

DtuBasedDatabase
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SecondaryServiceObjectiveName

Указывает имя цели службы, назначаемой базе данных-получателю.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

DtuBasedDatabase
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SecondaryType

Тип вторичной базы данных, если она является вторичной. Допустимыми значениями являются гео, именованные и резервные.

Свойства параметра

Тип:String
Default value:None
Допустимые значения:Named, Geo, Standby
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SecondaryVCore

Номера виртуальных ядер вторичной базы данных SQL Azure.

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Вместимость

Наборы параметров

VcoreBasedDatabase
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ServerName

Указывает имя SQL Server основного База данных SQL.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Tags

Указывает пары "Ключ-значение" в виде хэш-таблицы для связывания со ссылкой репликации База данных SQL. Например: @{key0="value0"; key1=$null; key2="value2"}

Свойства параметра

Тип:Hashtable
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Тег

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-UserAssignedIdentityId

Список назначенных пользователем удостоверений для копии База данных SQL.

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ZoneRedundant

Избыточность зоны для связывания с базой данных SQL Azure. Это свойство доступно только для баз данных гипермасштабирования.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

String

Выходные данные

AzureReplicationLinkModel