Compartilhar via

New-SqlHADREndpoint

  • Referência
Módulo:
SQLPS

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

Sintaxe

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

Description

O cmdlet New-SqlHADREndpoint cria um ponto de extremidade de espelhamento de banco de dados em uma instância de SQL Server. Este ponto de extremidade é necessário em cada instância do servidor que hospeda uma réplica de disponibilidade para qualquer grupo de disponibilidade. Cada instância de servidor somente poderá 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. Este ponto de extremidade usa a porta padrão 5022.

Exemplo 2: Criar um ponto de extremidade de espelhamento de banco de dados que requer 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

-AuthenticationOrder

Especifica a ordem e o tipo de autenticação usados pelo ponto de extremidade. Os valores válidos são:

  • Certificado
  • CertificateKerberos
  • CertificateNegotiate
  • CertificateNtlm
  • Kerberos
  • KerberosCertificate
  • Negotiate
  • NegotiateCertificate
  • Ntlm
  • NtlmCertificate.

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

Tipo:EndpointAuthenticationOrder
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 correspondente à 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 sua 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

-Encryption

Especifica a opção de criptografia para o ponto de extremidade. Os valores válidos são:

  • Desabilitado
  • Com suporte
  • Obrigatório

Obrigatório é o valor padrão.

Tipo:EndpointEncryption
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. Os valores válidos são:

  • Aes
  • AesRC4
  • Nenhum
  • RC4
  • RC4Aes

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

O algoritmo RC4 tem suporte somente 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 AES.

Tipo:EndpointEncryptionAlgorithm
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 SQL Server em que o ponto de extremidade é criado.

Tipo:Server
Cargo:3
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. Este parâmetro é necessário.

Tipo:String
Cargo:2
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, este é 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 SQL Server do ponto de extremidade. Esse parâmetro é opcional. Se não for especificado, o local de trabalho atual será usado.

Tipo:String
Cargo:3
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á 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

-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

-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

SMO.Server

Saídas

SMO.Endpoint