Partilhar via


New-SqlHADREndpoint

Cria um ponto de extremidade de espelhamento de banco de dados em uma instância do SQL Server.

Sintaxe

New-SqlHADREndpoint
   [-Port <Int32>]
   [-Owner <String>]
   [-Certificate <String>]
   [-IpAddress <IPAddress>]
   [-AuthenticationOrder <EndpointAuthenticationOrder>]
   [-Encryption <EndpointEncryption>]
   [-EncryptionAlgorithm <EndpointEncryptionAlgorithm>]
   [-Name] <String>
   [[-Path] <String>]
   [-Script]
   [-AccessToken <PSObject>]
   [-TrustServerCertificate]
   [-HostNameInCertificate <String>]
   [-Encrypt <String>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-SqlHADREndpoint
   [-Port <Int32>]
   [-Owner <String>]
   [-Certificate <String>]
   [-IpAddress <IPAddress>]
   [-AuthenticationOrder <EndpointAuthenticationOrder>]
   [-Encryption <EndpointEncryption>]
   [-EncryptionAlgorithm <EndpointEncryptionAlgorithm>]
   [-Name] <String>
   [-InputObject] <Server>
   [-Script]
   [-AccessToken <PSObject>]
   [-TrustServerCertificate]
   [-HostNameInCertificate <String>]
   [-Encrypt <String>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-SqlHADREndpoint cria um ponto de extremidade de espelhamento de banco de dados em uma instância do SQL Server. Esse ponto de extremidade é necessário em cada instância de servidor que hospeda uma réplica de disponibilidade para qualquer grupo de disponibilidade. Cada instância do servidor só pode ter um ponto de extremidade de espelhamento de banco de dados. Se uma instância de servidor possuir um ponto de extremidade de espelhamento de banco de dados, use o ponto de extremidade existente.

Exemplos

Exemplo 1: Criar um ponto de extremidade de espelhamento de banco de dados

PS C:\> New-SqlHADREndpoint -Path "SQLSERVER:\Sql\Computer\Instance" -Name "MainEndpoint"

Esse comando cria um ponto de extremidade de espelhamento de banco de dados chamado MainEndpoint na instância do servidor localizada no caminho especificado. Esse ponto de extremidade usa a porta padrão, 5022.

Exemplo 2: criar um ponto de extremidade de espelhamento de banco de dados que exija criptografia

PS C:\> New-SqlHADREndpoint -Path "SQLSERVER:\Sql\Computer\Instance" -Name "MainEndpoint" -Port 4022 -EncryptionAlgorithm Aes -Encryption Required

Esse comando cria um ponto de extremidade de espelhamento de banco de dados chamado MainEndpoint na instância do servidor localizada no caminho especificado. Esse ponto de extremidade escuta na porta 4022. O ponto de extremidade usa o algoritmo AES para criptografia e exige que as conexões usem criptografia.

Exemplo 3: criar um ponto de extremidade de espelhamento de banco de dados criptografado com um certificado

PS C:\> New-SqlHADREndpoint -Path "SQLSERVER:\Sql\Computer\Instance" -Name "MainEndpoint" -AuthenticationOrder Certificate -Certificate "EncryptionCertificate"

Esse comando cria um ponto de extremidade de espelhamento de banco de dados chamado MainEndpoint na instância do servidor localizada no caminho especificado. Esse ponto de extremidade usa o certificado chamado EncryptionCertificate para autenticar conexões.

Exemplo 4: Criar um script de ponto de extremidade de espelhamento de banco de dados

PS C:\> New-SqlHADREndpoint -Path "SQLSERVER:\Sql\Computer\Instance" -Name "MainEndpoint" -Script

Esse comando gera o script Transact-SQL que cria um ponto de extremidade de espelhamento de banco de dados chamado MainEndpoint na instância do servidor localizada no caminho especificado. O ponto de extremidade não é realmente criado por este comando.

Parâmetros

-AccessToken

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.

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

-AuthenticationOrder

Especifica a ordem e o tipo de autenticação usados pelo ponto de extremidade.

Se a opção especificada chamar um certificado, o parâmetro Certificado deverá ser definido.

Tipo:EndpointAuthenticationOrder
Valores aceitos:Ntlm, Kerberos, Negotiate, Certificate, NtlmCertificate, KerberosCertificate, NegotiateCertificate, CertificateNtlm, CertificateKerberos, CertificateNegotiate
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Certificate

Especifica o nome do certificado que o ponto de extremidade usará para autenticar conexões. O ponto de extremidade distante deve ter um certificado com a chave pública que corresponda à chave privada do certificado.

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

-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

-Encrypt

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.

Tipo:String
Valores aceitos:Mandatory, Optional, Strict
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Encryption

Especifica a opção de criptografia para o ponto de extremidade.

O valor padrão é Required.

Tipo:EndpointEncryption
Valores aceitos:Disabled, Supported, Required
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EncryptionAlgorithm

Especifica a forma de criptografia usada pelo ponto de extremidade.

Por padrão, o ponto de extremidade usará a criptografia do Aes.

OBSERVAÇÃO: O algoritmo RC4 só tem suporte para compatibilidade com versões anteriores. O novo material só pode ser criptografado usando RC4 ou RC4_128 quando o banco de dados está no nível de compatibilidade 90 ou 100, mas isso não é recomendado. Para aumentar a segurança, use um algoritmo mais recente, como um dos algoritmos de AES.

Tipo:EndpointEncryptionAlgorithm
Valores aceitos:None, RC4, Aes, AesRC4, RC4Aes
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-HostNameInCertificate

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.

Tipo:String
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 o ponto de extremidade é criado.

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

-IpAddress

Especifica o endereço IP do ponto de extremidade. O padrão é ALL, que indica que o ouvinte aceita uma conexão em qualquer endereço IP válido.

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

-Name

Especifica o nome do ponto de extremidade.

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

-Owner

Especifica o logon do proprietário do ponto de extremidade. Por padrão, esse é o logon atual.

Tipo:String
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 do ponto de extremidade. Se não for especificado, o local de trabalho atual será usado.

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

-Port

Especifica a porta TCP na qual o ponto de extremidade escutará as conexões. O padrão é 5022.

Tipo:Int32
Cargo:Named
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

-Script

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

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

-TrustServerCertificate

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.

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

Saídas

SMO.Endpoint