Compartilhar via

New-SqlHADREndpoint

Módulo:
SQLPS Module

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

Sintaxe

ByPath (Padrão) 

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

ByObject 

New-SqlHADREndpoint
    [-Name] <String>
    [-InputObject] <Server>
    [-Port <Int32>]
    [-Owner <String>]
    [-Certificate <String>]
    [-IpAddress <IPAddress>]
    [-AuthenticationOrder <EndpointAuthenticationOrder>]
    [-Encryption <EndpointEncryption>]
    [-EncryptionAlgorithm <EndpointEncryptionAlgorithm>]
    [-Script]
    [-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

-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
  • Negociar
  • NegotiateCertificate
  • Ntlm
  • NtlmCertificate.

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

Propriedades do parâmetro

Tipo:EndpointAuthenticationOrder
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Encryption

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

  • Desabilitado
  • Suportado
  • Obrigatório

Obrigatório é o valor padrão.

Propriedades do parâmetro

Tipo:EndpointEncryption
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 do 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 do AES.

Propriedades do parâmetro

Tipo:EndpointEncryptionAlgorithm
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-InputObject

Especifica o objeto de servidor da instância do SQL Server em que o ponto de extremidade é criado.

Propriedades do parâmetro

Tipo:Server
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByObject
Cargo:3
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:IPAddress
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica o nome do ponto de extremidade. Este parâmetro é obrigatório.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Owner

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Path

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByPath
Cargo:3
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Port

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

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Script

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

SMO.Server

Saídas

SMO.Endpoint