New-SqlHADREndpoint

Module:

SQLServer

Crée un point de terminaison de mise en miroir de bases de données sur une instance SQL Server.

Syntaxe

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

La cmdlet New-SqlHADREndpoint crée un point de terminaison de mise en miroir de bases de données sur une instance SQL Server. Ce point de terminaison est requis sur chaque instance de serveur qui héberge un réplica de disponibilité pour n’importe quel groupe de disponibilité. Chaque instance de serveur ne peut avoir qu’un seul point de terminaison de mise en miroir de bases de données. Si une instance de serveur possède un point de terminaison de mise en miroir de bases de données, utilisez le point de terminaison existant.

Exemples

Exemple 1 : Créer un point de terminaison de mise en miroir de bases de données

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

Cette commande crée un point de terminaison de mise en miroir de bases de données nommé MainEndpoint sur l’instance de serveur située au niveau du chemin spécifié. Ce point de terminaison utilise le port par défaut, 5022.

Exemple 2 : Créer un point de terminaison de mise en miroir de bases de données qui nécessite un chiffrement

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

Cette commande crée un point de terminaison de mise en miroir de bases de données nommé MainEndpoint sur l’instance de serveur située au niveau du chemin spécifié. Ce point de terminaison écoute sur le port 4022. Le point de terminaison utilise l’algorithme AES pour le chiffrement et nécessite que les connexions utilisent le chiffrement.

Exemple 3 : Créer un point de terminaison de mise en miroir de bases de données chiffré avec un certificat

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

Cette commande crée un point de terminaison de mise en miroir de bases de données nommé MainEndpoint sur l’instance de serveur située au niveau du chemin spécifié. Ce point de terminaison utilise le certificat nommé EncryptionCertificate pour authentifier les connexions.

Exemple 4 : Créer un script de point de terminaison de mise en miroir de bases de données

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

Cette commande génère le script Transact-SQL qui crée un point de terminaison de mise en miroir de bases de données nommé MainEndpoint sur l’instance de serveur située sur le chemin spécifié. Le point de terminaison n’est pas réellement créé par cette commande.

Paramètres

-AccessToken

Jeton d’accès utilisé pour s’authentifier auprès de SQL Server, comme alternative à l’authentification utilisateur/mot de passe ou Windows.

Cela peut être utilisé, par exemple, pour se connecter à SQL Azure DB et SQL Azure Managed Instance à l’aide d’un Service Principal ou d’un Managed Identity.

Le paramètre à utiliser peut être une chaîne représentant le jeton ou un objet PSAccessToken tel qu’il est retourné en exécutant Get-AzAccessToken -ResourceUrl https://database.windows.net.

Ce paramètre est nouveau dans v22 du module.

Type:	PSObject
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-AuthenticationOrder

Spécifie l’ordre et le type d’authentification utilisés par le point de terminaison.

Si l’option spécifiée appelle un certificat, le paramètre Certificate doit être défini.

Type:	EndpointAuthenticationOrder
Valeurs acceptées:	Ntlm, Kerberos, Negotiate, Certificate, NtlmCertificate, KerberosCertificate, NegotiateCertificate, CertificateNtlm, CertificateKerberos, CertificateNegotiate
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Certificate

Spécifie le nom du certificat que le point de terminaison utilisera pour authentifier les connexions. Le point de terminaison lointain doit avoir un certificat avec la clé publique correspondant à la clé privée du certificat.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:	SwitchParameter
Alias:	cf
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Encrypt

Type de chiffrement à utiliser lors de la connexion à SQL Server.

Cette valeur est mappée à la propriété EncryptSqlConnectionEncryptOption sur l’objet SqlConnection du pilote Microsoft.Data.SqlClient.

Dans la version 22 du module, la valeur par défaut est Optional (pour la compatibilité avec v21). Dans la version 23+ du module, la valeur par défaut est « Obligatoire », ce qui peut créer une modification cassant pour les scripts existants.

Ce paramètre est nouveau dans v22 du module.

Type:	String
Valeurs acceptées:	Mandatory, Optional, Strict
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Encryption

Spécifie l’option de chiffrement du point de terminaison.

La valeur par défaut est Required.

Type:	EndpointEncryption
Valeurs acceptées:	Disabled, Supported, Required
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-EncryptionAlgorithm

Spécifie la forme de chiffrement utilisée par le point de terminaison.

Par défaut, le point de terminaison utilise le chiffrement Aes.

REMARQUE : L’algorithme RC4 n’est pris en charge que pour la compatibilité descendante. De nouveaux matériaux ne peuvent être chiffrés qu’à l’aide de RC4 ou de RC4_128 lorsque la base de données est au niveau de compatibilité 90 ou 100, mais cela n’est pas recommandé. Pour renforcer la sécurité, utilisez un algorithme plus récent, tel que l’un des algorithmes AES à la place.

Type:	EndpointEncryptionAlgorithm
Valeurs acceptées:	None, RC4, Aes, AesRC4, RC4Aes
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-HostNameInCertificate

Nom d’hôte à utiliser pour valider le certificat TLS/SSL SQL Server. Vous devez passer ce paramètre si votre instance SQL Server est activée pour Forcer le chiffrement et que vous souhaitez vous connecter à une instance à l’aide du nom d’hôte/shortname. Si ce paramètre est omis, le passage du nom de domaine complet (FQDN) à -ServerInstance est nécessaire pour se connecter à une instance SQL Server activée pour Forcer le chiffrement.

Ce paramètre est nouveau dans v22 du module.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-InputObject

Spécifie l’objet serveur de l’instance SQL Server où le point de terminaison est créé.

Type:	Server
Position:	2
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-IpAddress

Spécifie l’adresse IP du point de terminaison. La valeur par défaut est ALL, ce qui indique que l’écouteur accepte une connexion sur n’importe quelle adresse IP valide.

Type:	IPAddress
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Name

Spécifie le nom du point de terminaison.

Type:	String
Position:	1
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Owner

Spécifie la connexion du propriétaire du point de terminaison. Par défaut, il s’agit de la connexion actuelle.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Path

Spécifie le chemin d’accès à l’instance SQL Server du point de terminaison. S’il n’est pas spécifié, l’emplacement de travail actuel est utilisé.

Type:	String
Position:	2
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Port

Spécifie le port TCP sur lequel le point de terminaison écoute les connexions. La valeur par défaut est 5022.

Type:	Int32
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ProgressAction

Détermine comment PowerShell répond aux mises à jour de progression générées par un script, une applet de commande ou un fournisseur, telles que les barres de progression générées par l’applet de commande Write-Progress. L’applet de commande Write-Progress crée des barres de progression qui affichent l’état d’une commande.

Type:	ActionPreference
Alias:	proga
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Script

Indique que cette applet de commande retourne un script Transact-SQL qui effectue la tâche.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-TrustServerCertificate

Indique si le canal sera chiffré lors du contournement de la marche à pied de la chaîne de certificats pour valider l’approbation.

Dans la version 22 du module, la valeur par défaut est $true (pour la compatibilité avec v21). Dans v23+ du module, la valeur par défaut est « $false », ce qui peut créer une modification cassant pour les scripts existants.

Ce paramètre est nouveau dans v22 du module.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:	SwitchParameter
Alias:	wi
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

Microsoft.SqlServer.Management.Smo.Server

Sorties

SMO.Endpoint

Liens associés

• Set-SqlHADREndpoint