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 RequiredEsse 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" -ScriptEsse 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