Set-SqlAvailabilityReplica

O token de acesso usado para autenticar no SQL Server, como uma alternativa ao usuário/senha ou à Autenticação do Windows.

Isso pode ser usado, por exemplo, para se conectar a SQL Azure DB e SQL Azure Managed Instance usando um Service Principal ou um Managed Identity.

O parâmetro a ser usado pode ser uma cadeia de caracteres que representa o token ou um objeto PSAccessToken conforme retornado executando Get-AzAccessToken -ResourceUrl https://database.windows.net.

Esse parâmetro é novo na v22 do módulo.

Especifica o modo de disponibilidade da réplica.

Você pode especificar um valor de $Null.

Especifica a prioridade desejada das réplicas na execução de backups. Os valores aceitáveis para esse parâmetro são inteiros de 0 a 100. Do conjunto de réplicas que estão online e disponíveis, a réplica que tem a prioridade mais alta executa o backup.

Um valor zero (0) indica que a réplica não é um candidato.

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

Especifica como a réplica de disponibilidade lida com conexões quando está na função primária. Os valores aceitáveis para este parâmetro são:

• AllowReadWriteConnections. Permite conexões de leitura/gravação.
• AllowAllConnections. Permite todas as conexões.

Especifica como a réplica de disponibilidade lida com conexões quando na função secundária. Os valores aceitáveis para este parâmetro são:

• AllowNoConnections. Não permite conexões.
• AllowReadIntentConnectionsOnly. Permite apenas conexões de intenção de leitura.
• AllowAllConnections. Permite todas as conexões.

O tipo de criptografia a ser usado ao se conectar ao SQL Server.

Esse valor é mapeado para a propriedade EncryptSqlConnectionEncryptOption no objeto SqlConnection do driver Microsoft.Data.SqlClient.

Na v22 do módulo, o padrão é Optional (para compatibilidade com v21). Na v23+ do módulo, o valor padrão será 'Obrigatório', o que pode criar uma alteração significativa para scripts existentes.

Esse parâmetro é novo na v22 do módulo.

Especifica a URL do ponto de extremidade de espelhamento de banco de dados. Essa URL é um endereço TCP no seguinte formulário: TCP://system-address:port

Especifica o modo de failover.

Você pode especificar um valor de $Null.

O nome do host a ser usado na validação do certificado TLS/SSL do SQL Server. Você deve passar esse parâmetro se a instância do SQL Server estiver habilitada para o Force Encryption e quiser se conectar a uma instância usando nome de host/nome curto. Se esse parâmetro for omitido, passar o FQDN (Nome de Domínio Totalmente Qualificado) para -ServerInstance será necessário para se conectar a uma instância do SQL Server habilitada para o Force Encryption.

Esse parâmetro é novo na v22 do módulo.

Especifica o grupo de disponibilidade, como um objeto AvailabilityGroup, ao qual a réplica pertence.

Especifica a lista de roteamento somente leitura com balanceamento de carga.

A lista de roteamento é uma lista de conjuntos com balanceamento de carga, que, por sua vez, são listas de réplicas.

Por exemplo, passar um valor como

@('Server1','Server2'),@('Server3'),@('Server4')

significa o que estamos passando 3 conjuntos com balanceamento de carga: 1 com 2 réplicas (Server1 e Server2) e 2 com apenas um (Server3 e Server4, respectivamente).

No runtime, o SQL Server examinará sequencialmente todos os conjuntos com balanceamento de carga até encontrar um de modo que pelo menos na réplica esteja disponível e use-o para balanceamento de carga.

Portanto, no exemplo acima, se o Server1 e o Server2 não estiverem disponíveis, mas o Server3 estiver, o SQL Server escolherá Server3.

Esse cmdlet define apenas a lista de roteamento somente leitura e não verifica a disponibilidade das réplicas especificadas.

Especifica o caminho do grupo de disponibilidade ao qual a réplica pertence. Se você não especificar esse parâmetro, esse cmdlet usará o local de trabalho atual.

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.

Especifica o FQDN (nome de domínio totalmente qualificado) e a porta a serem usadas ao rotear para a réplica para conexões somente leitura, como no exemplo a seguir: TCP://DBSERVER8.manufacturing.Contoso.com:7024

Especifica uma lista ordenada de nomes de servidor de réplica que representam a sequência de investigação para o diretor de conexão usar ao redirecionar conexões somente leitura por meio dessa réplica de disponibilidade. Esse parâmetro se aplica se a réplica de disponibilidade é a réplica primária atual do grupo de disponibilidade.

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

Especifica como a réplica secundária será inicialmente propagada.

Valores permitidos:

• Automático. Habilita a propagação direta. Esse método propagará a réplica secundária pela rede. Esse método não exige que você faça backup e restaure uma cópia do banco de dados primário na réplica.
• Manual. Especifica a propagação manual. Esse método exige que você crie um backup do banco de dados na réplica primária e restaure manualmente esse backup na réplica secundária.

Especifica a quantidade de tempo, em segundos, para aguardar uma resposta entre a réplica primária e essa réplica antes que a conexão falhe.

Indica se o canal será criptografado ao ignorar a cadeia de certificados para validar a confiança.

Na v22 do módulo, o padrão é $true (para compatibilidade com v21). Na v23+ do módulo, o valor padrão será "$false", o que pode criar uma alteração significativa para scripts existentes.

Esse parâmetro é novo na v22 do módulo.

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