Disable-SqlAlwaysOn

  • Referência
Módulo:
SQLServer

Desabilita o recurso Grupos de Disponibilidade AlwaysOn para um servidor.

Sintaxe

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

Description

O cmdlet Disable-SqlAlwaysOn desabilita o recurso grupos de vaibilidade Always On em uma instância do SQL Server.

Se o recurso Grupos de Disponibilidade AlwaysOn estiver desabilitado enquanto o serviço 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 desabilitado, esse cmdlet não fará alterações.

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: Desabilitar Grupos de Disponibilidade AlwaysOn no caminho especificado

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

Esse comando desabilita Grupos de Disponibilidade AlwaysOn na instância do SQL Server localizada no caminho especificado. Esse comando requer a reinicialização da instância do servidor e você será solicitado a confirmar essa reinicialização.

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

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

Esse comando desabilita 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: Desabilitar Grupos de Disponibilidade AlwaysOn para a instância de servidor especificada

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

Esse comando desabilita Grupos de Disponibilidade AlwaysOn na instância do SQL Server chamada 'Computador\Instância'. Esse comando requer a reinicialização da instância e você será solicitado a confirmar essa reinicialização.

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

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

Esse comando desabilita Grupos de Disponibilidade AlwaysOn na instância do SQL Server chamada "Computador\Instância" usando a autenticação do Windows. Você será solicitado a inserir a senha da conta especificada, 'DOMAIN\Username'. Essa alteração requer a reinicialização da instância e você também será solicitado a confirmar essa reinicialização.

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

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

Esse comando desabilita 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 uma credencial do Windows que tem permissão para alterar a configuração Always On na instância do SQL Server.

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 em que a configuração Grupos de Disponibilidade AlwaysOn está desabilitada.

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 valor do 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 em que Always On está desabilitado. O formato deve ser MACHINENAME\INSTANCE. Use o parâmetro Credencial para alterar a configuração Always On em um servidor remoto.

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