Compartilhar via

New-SqlAvailabilityGroup

Módulo:
SQLPS Module

Cria um grupo de disponibilidade.

Sintaxe

ByPath (Padrão) 

New-SqlAvailabilityGroup
    [-Name] <String>
    [[-Path] <String>]
    -AvailabilityReplica <AvailabilityReplica[]>
    [-Database <String[]>]
    [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
    [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
    [-HealthCheckTimeout <Int32>]
    [-BasicAvailabilityGroup]
    [-DatabaseHealthTrigger]
    [-DtcSupportEnabled]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObject 

New-SqlAvailabilityGroup
    [-Name] <String>
    [-InputObject] <Server>
    -AvailabilityReplica <AvailabilityReplica[]>
    [-Database <String[]>]
    [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
    [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
    [-HealthCheckTimeout <Int32>]
    [-BasicAvailabilityGroup]
    [-DatabaseHealthTrigger]
    [-DtcSupportEnabled]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet New-SqlAvailabilityGroup cria um grupo de disponibilidade em Grupos de Disponibilidade AlwaysOn. O parâmetro InputObject ou Path especifica o servidor que hospeda a réplica primária inicial.

Exemplos

Exemplo 1: Criar um grupo de disponibilidade

PS C:\> $PrimaryServer = Get-Item "SQLSERVER:\SQL\PrimaryServer\Instance22"
PS C:\> $SecondaryServer = Get-Item "SQLSERVER:\SQL\SecondaryServer\Instance22"
PS C:\> $PrimaryReplica = New-SqlAvailabilityReplica -Name "PrimaryServer\Instance22" -EndpointUrl "TCP://PrimaryServer.domain:5022" -FailoverMode "Automatic" -AvailabilityMode "SynchronousCommit" -AsTemplate -Version ($PrimaryServer.Version)
PS C:\> $SecondaryReplica = New-SqlAvailabilityReplica -Name "SecondaryServer\Instance22" -EndpointUrl "TCP://SecondaryServer.domain:5022" -FailoverMode "Automatic" -AvailabilityMode "SynchronousCommit" -AsTemplate -Version ($SecondaryServer.Version)
PS C:\> New-SqlAvailabilityGroup -InputObject $PrimaryServer -Name "MainAG" -AvailabilityReplica ($PrimaryReplica, $SecondaryReplica) -Database @("Database01","Database02")

O primeiro comando obtém uma instância do SQL Server no servidor primário e, em seguida, armazena-a na variável $PrimaryServer.

O segundo comando obtém uma instância do SQL Server no servidor secundário e, em seguida, armazena-a na variável $SecondaryServer.

O terceiro comando cria uma réplica que inclui a instância do servidor primário usando o cmdlet New-SqlAvailabilityReplica e, em seguida, a armazena na variável $PrimaryReplica. O comando especifica a versão da instância do servidor usando a propriedade Version do $PrimaryServer.

O quarto comando cria uma réplica que inclui a instância do servidor secundário usando New-SqlAvailabilityReplica e, em seguida, a armazena na variável $SecondaryReplica. O comando especifica a versão da instância do servidor usando a propriedade Version do $SecondaryServer.

O comando final cria o grupo de disponibilidade. Ele especifica o nome, o servidor primário, as réplicas e outras informações.

Parâmetros

-AutomatedBackupPreference

Especifica a preferência de backup automatizado para o grupo de disponibilidade. Os valores aceitáveis para este parâmetro são:

  • Primário. Especifica que os backups sempre ocorrem na réplica primária. Essa opção dá suporte ao uso de recursos não disponíveis quando o backup é executado em uma réplica secundária, como backups diferenciais.
  • SecondaryOnly. Especifica que os backups nunca são executados em réplicas primárias. Se a réplica primária for a única réplica online, o backup não ocorrerá.
  • Secundário. Especifica que os backups ocorrem em réplicas secundárias, a menos que a réplica primária seja a única réplica online. Em seguida, o backup ocorre na réplica primária.
  • Nenhum. Especifica que o status primário ou secundário não é levado em conta ao decidir qual réplica executa backups. Em vez disso, a prioridade de backup e o status online determinam qual réplica executa backups.

Propriedades do parâmetro

Tipo:AvailabilityGroupAutomatedBackupPreference
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AvailabilityReplica

Especifica uma matriz de réplicas de disponibilidade que esse cmdlet inclui no grupo de disponibilidade. Para obter um objeto AvailabilityReplica , use o cmdlet New-SqlAvailabilityReplica . Especifique o parâmetro AsTemplate .

Propriedades do parâmetro

Tipo:

AvailabilityReplica[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-BasicAvailabilityGroup

O cmdlet New-SqlAvailabilityGroup cria um grupo de disponibilidade em Grupos de Disponibilidade AlwaysOn. O parâmetro InputObject ou Path especifica o servidor que hospeda a réplica primária inicial.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Database

Especifica uma matriz de bancos de dados de usuário locais de leitura/gravação. Esses bancos de dados devem usar o modelo de recuperação completa e não devem usar AUTO_CLOSE. Esses bancos de dados não podem pertencer a outro grupo de disponibilidade e não podem ser configurados para espelhamento de banco de dados. Você deve especificar um valor para esse parâmetro.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DatabaseHealthTrigger

O cmdlet New-SqlAvailabilityGroup cria um grupo de disponibilidade em Grupos de Disponibilidade AlwaysOn. O parâmetro InputObject ou Path especifica o servidor que hospeda a réplica primária inicial.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DtcSupportEnabled

O cmdlet New-SqlAvailabilityGroup cria um grupo de disponibilidade em Grupos de Disponibilidade AlwaysOn. O parâmetro InputObject ou Path especifica o servidor que hospeda a réplica primária inicial.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-FailureConditionLevel

Especifica o comportamento de failover automático do grupo de disponibilidade. Os valores aceitáveis para este parâmetro são:

  • OnServerDown. Failover ou reinicialização se o serviço do SQL Server for interrompido.
  • OnServerUnresponsive. Failover ou reinicialização se qualquer condição de valor inferior for atendida, além de quando o serviço do SQL Server estiver conectado ao cluster e o limite HealthCheckTimeout for excedido ou se a réplica de disponibilidade atualmente na função primária estiver em um estado de falha.
  • OnCriticalServerError. Failover ou reinicialização se qualquer condição de valor inferior for atendida, além de quando ocorrer um erro interno crítico do Servidor, que incluem condição de memória insuficiente, violação grave de acesso de gravação ou muito despejo.
  • OnModerateServerError. Failover ou reinicialização se qualquer condição de valor inferior for atendida, além disso, se ocorrer um erro moderado do servidor, que inclui condição persistente fora da memória.
  • OnAnyQualifiedFailureConditions. Failover ou reinicialização se qualquer condição de valor inferior for atendida, além disso, se ocorrer uma condição de falha qualificada, que inclui esgotamento de thread de trabalho do mecanismo e deadlock insolúvel detectado.

Propriedades do parâmetro

Tipo:AvailabilityGroupFailureConditionLevel
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-HealthCheckTimeout

Especifica o período de tempo, em milissegundos, após o qual os grupos de disponibilidade AlwaysOn declaram que um servidor sem resposta não está íntegro.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-InputObject

Especifica a instância do SQL Server que hospeda a réplica primária do grupo de disponibilidade que esse cmdlet cria.

Propriedades do parâmetro

Tipo:Server
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByObject
Cargo:3
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica o nome do grupo de disponibilidade que esse cmdlet cria.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Path

Especifica o caminho da instância do SQL Server que hospeda a réplica primária inicial do grupo de disponibilidade que esse cmdlet cria. Se você não especificar esse parâmetro, esse cmdlet usará o local de trabalho atual. Se você especificar um valor, o caminho deverá existir no momento.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByPath
Cargo:3
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Script

Indica que esse cmdlet retorna um script Transact-SQL que executa a tarefa executada por esse cmdlet.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

Microsoft.SqlServer.Management.Smo.Server

Você pode passar uma instância de servidor para este cmdlet.

Saídas

Microsoft.SqlServer.Management.Smo.AvailabilityGroup

Esse cmdlet retorna um grupo de disponibilidade.