Partager via

New-SqlHADREndpoint

Module:
SQLPS Module

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

Syntaxe

ByPath (Par défaut) 

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

L’applet de commande 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 chemin d’accès 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 chemin d’accès spécifié. Ce point de terminaison écoute 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 chemin d’accès 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 au chemin spécifié. Le point de terminaison n’est pas réellement créé par cette commande.

Paramètres

-AuthenticationOrder

Spécifie l’ordre et le type d’authentification utilisés par le point de terminaison. Les valeurs valides sont les suivantes :

  • Certificat
  • CertificateKerberos
  • CertificateNegotiate
  • CertificateNtlm
  • Kerberos
  • KerberosCertificate
  • Négocier
  • NegotiateCertificate
  • Ntlm
  • NtlmCertificate.

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

Propriétés du paramètre

Type:EndpointAuthenticationOrder
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Encryption

Spécifie l’option de chiffrement du point de terminaison. Les valeurs valides sont les suivantes :

  • Handicapé
  • Soutenu
  • Obligatoire

Obligatoire est la valeur par défaut.

Propriétés du paramètre

Type:EndpointEncryption
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-EncryptionAlgorithm

Spécifie la forme de chiffrement utilisée par le point de terminaison. Les valeurs valides sont les suivantes :

  • Aes
  • AesRC4
  • Aucun
  • RC4
  • RC4Aes

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

L'algorithme RC4 est uniquement pris en charge pour des raisons de 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 plutôt un algorithme plus récent comme l’un des algorithmes AES.

Propriétés du paramètre

Type:EndpointEncryptionAlgorithm
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-InputObject

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

Propriétés du paramètre

Type:Server
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ByObject
Position:3
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:IPAddress
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Name

Spécifie le nom du point de terminaison. Ce paramètre est obligatoire.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Owner

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Path

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ByPath
Position:3
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Port

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

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Script

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

SMO.Server

Sorties

SMO.Endpoint