New-SqlHADREndpoint
Cria um ponto de extremidade de espelhamento de banco de dados em uma instância de SQL Server.
Syntax
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>]
[-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>]
[-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 de 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 de servidor localizada no caminho especificado. Esse ponto de extremidade escuta na porta 4022
.
O ponto de extremidade usa o AES
algoritmo para criptografia e requer 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 de 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 de 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 em SQL Server, como uma alternativa ao usuário/senha ou à Autenticação do Windows.
Isso pode ser usado, por exemplo, para se conectar e SQL Azure DB
SQL Azure Managed Instance
usar 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 PSAccessToken
objeto conforme retornado executando Get-AzAccessToken -ResourceUrl https://database.windows.net
.
Esse parâmetro é novo na v22 do módulo.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 Certificate deverá ser definido.
Type: | EndpointAuthenticationOrder |
Accepted values: | Ntlm, Kerberos, Negotiate, Certificate, NtlmCertificate, KerberosCertificate, NegotiateCertificate, CertificateNtlm, CertificateKerberos, CertificateNegotiate |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Encrypt
O tipo de criptografia a ser usado ao se conectar a SQL Server.
Esse valor é mapeado para a Encrypt
propriedade SqlConnectionEncryptOption
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 interruptiva para scripts existentes.
Esse parâmetro é novo na v22 do módulo.
Type: | String |
Accepted values: | Mandatory, Optional, Strict |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Encryption
Especifica a opção de criptografia para o ponto de extremidade.
O valor padrão é Required
.
Type: | EndpointEncryption |
Accepted values: | Disabled, Supported, Required |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EncryptionAlgorithm
Especifica a forma de criptografia usada pelo ponto de extremidade.
Por padrão, o ponto de extremidade usará a criptografia 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 AES
algoritmos.
Type: | EndpointEncryptionAlgorithm |
Accepted values: | None, RC4, Aes, AesRC4, RC4Aes |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 de SQL Server estiver habilitada para Forçar Criptografia e quiser se conectar a uma instância usando nome do host/nome curto. Se esse parâmetro for omitido, será necessário passar o FQDN (Nome de Domínio Totalmente Qualificado) para -ServerInstance para se conectar a uma instância de SQL Server habilitada para Forçar Criptografia.
Esse parâmetro é novo na v22 do módulo.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifica o objeto de servidor da instância SQL Server em que o ponto de extremidade é criado.
Type: | Server |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | IPAddress |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifica o nome do ponto de extremidade.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Owner
Especifica o logon do proprietário do ponto de extremidade. Por padrão, este é o logon atual.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Especifica o caminho para a instância SQL Server do ponto de extremidade. Se não for especificado, o local de trabalho atual será usado.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Port
Especifica a porta TCP na qual o ponto de extremidade escutará conexões.
O padrão é 5022
.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Script
Indica que esse cmdlet retorna um script Transact-SQL que executa a tarefa.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TrustServerCertificate
Indica se o canal será criptografado ao ignorar a movimentação da 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 interruptiva para scripts existentes.
Esse parâmetro é novo na v22 do módulo.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.SqlServer.Management.Smo.Server
Saídas
SMO.Endpoint