Enable-SqlAlwaysOn

  • Referência
Módulo:
SQLServer

Habilita o recurso Grupos de Disponibilidade AlwaysOn.

Sintaxe

Enable-SqlAlwaysOn
      [[-Path] <String>]
      [-NoServiceRestart]
      [-Force]
      [-Credential <PSCredential>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Enable-SqlAlwaysOn
      [-InputObject] <Server>
      [-NoServiceRestart]
      [-Force]
      [-Credential <PSCredential>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Enable-SqlAlwaysOn
      -ServerInstance <String>
      [-NoServiceRestart]
      [-Force]
      [-Credential <PSCredential>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Enable-SqlAlwaysOn habilita o Always On em uma instância do SQL Server.

Se o recurso Grupos de Disponibilidade AlwaysOn estiver habilitado enquanto o serviço do SQL Server estiver em execução, o serviço do mecanismo de banco de dados deverá ser reiniciado para que as alterações sejam concluídas.

A menos que você especifique o parâmetro Force, o cmdlet solicitará que você reinicie o serviço.

Se o recurso Grupos de Disponibilidade AlwaysOn já estiver habilitado, nenhuma ação será executada.

Esse cmdlet pode ser executado em um serviço remoto.

Você deve ter permissões de Administrador para executar este cmdlet.

Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.

Exemplos

Exemplo 1: Habilitar Grupos de Disponibilidade AlwaysOn no caminho especificado

PS C:\> Enable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance"

Esse comando habilita grupos de disponibilidade AlwaysOn na instância do SQL Server localizada no caminho especificado. Essa alteração requer a reinicialização da instância e você será solicitado a confirmar essa reinicialização.

Exemplo 2: Habilitar Grupos de Disponibilidade AlwaysOn no caminho especificado e reiniciar o servidor sem confirmação

PS C:\> Enable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance" -Force

Esse comando habilita grupos de disponibilidade AlwaysOn na instância do SQL Server localizada no caminho especificado. A opção Forçar faz com que a instância do servidor seja reiniciada sem solicitar confirmação.

Exemplo 3: Habilitar grupos de disponibilidade AlwaysOn para a instância de servidor especificada

PS C:\> Enable-SqlAlwaysOn -ServerInstance "Computer\Instance"

Esse comando habilita grupos de disponibilidade AlwaysOn na instância do SQL Server chamada Computer\Instance. Essa alteração requer a reinicialização da instância e você será solicitado a confirmar essa reinicialização.

Exemplo 4: Habilitar Grupos de Disponibilidade AlwaysOn para a instância de servidor especificada usando a autenticação do Windows

PS C:\> Enable-SqlAlwaysOn -ServerInstance "Computer\Instance" -Credential (Get-Credential "DOMAIN\Username")

Esse comando habilita grupos de disponibilidade AlwaysOn na instância do SQL Server chamada 'Computer\Instance' usando a autenticação do Windows. Você será solicitado a inserir a senha da conta especificada. Essa alteração requer a reinicialização da instância e você também será solicitado a confirmar essa reinicialização.

Exemplo 5: Habilitar Grupos de Disponibilidade AlwaysOn no caminho especificado sem reiniciar o servidor

PS C:\> Enable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance" -NoServiceRestart

Esse comando habilita grupos de disponibilidade AlwaysOn na instância do SQL Server localizada no caminho especificado, mas o comando não reinicia a instância. A alteração não entrará em vigor até que você reinicie manualmente essa instância do servidor.

Parâmetros

-Confirm

Solicita a 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

-Credential

Especifica o nome da instância do SQL Server na qual habilitar o recurso Grupos de Disponibilidade AlwaysOn. O formato é MACHINENAME\INSTANCE. Para habilitar essa configuração em um servidor remoto, use-a junto com o parâmetro Credential.

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

-Force

Força o comando a ser executado sem solicitar a confirmação do usuário. Esse parâmetro é fornecido para permitir a construção de scripts.

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

-InputObject

Especifica o objeto de servidor da instância do SQL Server.

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

-NoServiceRestart

Indica que o usuário não é solicitado a reiniciar o serviço do SQL Server. Você deve reiniciar manualmente o serviço do SQL Server para que as alterações entrem em vigor. Quando esse parâmetro é definido, Force é ignorado.

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

-Path

Especifica o caminho para a instância do SQL Server. Esse é um parâmetro opcional. Se não for especificado, o local de trabalho atual será usado.

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

-ProgressAction

Determina como o PowerShell responde às atualizações de progresso geradas por um script, cmdlet ou provedor, como as barras de progresso geradas pelo cmdlet Write-Progress. O cmdlet Write-Progress cria barras de progresso que mostram o status de um comando.

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

-ServerInstance

Especifica o nome da instância do SQL Server. O formato é MACHINENAME\INSTANCE. Para habilitar essa configuração em um servidor remoto, use-a junto com o parâmetro Credential.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
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

Entradas

Microsoft.SqlServer.Management.Smo.Server

System.String

Saídas

System.Object