New-SqlHADREndpoint

Module:

SQLServer

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

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

L’applet de commande New-SqlHADREndpoint crée un point de terminaison de mise en miroir de bases de données sur un SQL Server instance. Ce point de terminaison est requis sur chaque instance de serveur qui héberge un réplica de disponibilité pour tout groupe de disponibilité. Chaque instance de serveur ne peut posséder qu'un point de terminaison de mise en miroir de bases de données. Si un serveur instance 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 le serveur instance situé au 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 le serveur instance situé au chemin spécifié. Ce point de terminaison écoute sur le port 4022. Le point de terminaison utilise l’algorithme pour le AES chiffrement et exige 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 le serveur instance situé au 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 le serveur instance situé au chemin spécifié. Le point de terminaison n'est pas réellement créé par cette commande.

Paramètres

-AccessToken

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

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

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

Ce paramètre est nouveau dans v22 du module.

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
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

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Encrypt

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

Cette valeur est mappée à la Encrypt propriété SqlConnectionEncryptOption 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 v23+ 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
Accepted values:	Mandatory, Optional, Strict
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Encryption

Spécifie l’option de chiffrement pour le point de terminaison.

La valeur par défaut est Required.

Type:	EndpointEncryption
Accepted values:	Disabled, Supported, Required
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 est uniquement pris en charge pour la compatibilité descendante. Les nouveaux éléments ne peuvent être chiffrés qu’à l’aide de RC4 ou RC4_128 lorsque la base de données est au niveau de compatibilité 90 ou 100, mais cela n’est pas recommandé. Pour une sécurité accrue, utilisez plutôt un algorithme plus récent, tel que l’un AES des algorithmes.

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

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

Ce paramètre est nouveau dans v22 du module.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

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

Type:	Server
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Spécifie le nom du point de terminaison.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

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

Type:	String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Port

Spécifie le port TCP sur lequel le point de terminaison écoute les connexions. Par défaut, il s’agit de 5022.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Script

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TrustServerCertificate

Indique si le canal sera chiffré tout en contournant 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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entrées

Microsoft.SqlServer.Management.Smo.Server

Sorties

SMO.Endpoint

Liens associés

• Set-SqlHADREndpoint