Freigeben über

New-SqlHADREndpoint

Modul:
SQLPS Module

Erstellt einen Datenbankspiegelungsendpunkt in einer SQL Server-Instanz.

Syntax

ByPath (Standardwert) 

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>]

Beschreibung

Das Cmdlet New-SqlHADREndpoint erstellt einen Datenbankspiegelungsendpunkt in einer SQL Server-Instanz. Dieser Endpunkt ist für jede Serverinstanz erforderlich, die ein Verfügbarkeitsreplikat für jede Verfügbarkeitsgruppe hostt. Jede Serverinstanz kann nur einen Datenbankspiegelungsendpunkt haben. Wenn eine Serverinstanz über einen Datenbankspiegelungsendpunkt verfügt, verwenden Sie den vorhandenen Endpunkt.

Beispiele

Beispiel 1: Erstellen eines Datenbankspiegelungsendpunkts

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

Mit diesem Befehl wird ein Datenbankspiegelungsendpunkt namens "MainEndpoint" auf der Serverinstanz erstellt, die sich im angegebenen Pfad befindet. Dieser Endpunkt verwendet den Standardport 5022.

Beispiel 2: Erstellen eines Datenbankspiegelungsendpunkts, der Verschlüsselung erfordert

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

Mit diesem Befehl wird ein Datenbankspiegelungsendpunkt namens "MainEndpoint" auf der Serverinstanz erstellt, die sich im angegebenen Pfad befindet. Dieser Endpunkt überwacht Port 4022. Der Endpunkt verwendet den AES-Algorithmus für die Verschlüsselung und erfordert, dass Verbindungen Verschlüsselung verwenden.

Beispiel 3: Erstellen eines Datenbankspiegelungsendpunkts, der mit einem Zertifikat verschlüsselt ist

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

Mit diesem Befehl wird ein Datenbankspiegelungsendpunkt namens "MainEndpoint" auf der Serverinstanz erstellt, die sich im angegebenen Pfad befindet. Dieser Endpunkt verwendet das Zertifikat "EncryptionCertificate", um Verbindungen zu authentifizieren.

Beispiel 4: Erstellen eines Endpunktskripts für die Datenbankspiegelung

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

Mit diesem Befehl wird das skript Transact-SQL ausgegeben, das einen Datenbankspiegelungsendpunkt mit dem Namen "MainEndpoint" auf der Serverinstanz erstellt, die sich im angegebenen Pfad befindet. Der Endpunkt wird nicht tatsächlich von diesem Befehl erstellt.

Parameter

-AuthenticationOrder

Gibt die Reihenfolge und den Typ der Authentifizierung an, die vom Endpunkt verwendet wird. Gültige Werte sind:

  • Zertifikat
  • CertificateKerberos
  • CertificateNegotiate
  • CertificateNtlm
  • Kerberos
  • KerberosCertificate
  • Verhandeln
  • NegotiateCertificate
  • Ntlm
  • NtlmCertificate.

Wenn die angegebene Option ein Zertifikat aufruft, muss der Parameter "Certificate " festgelegt werden.

Parametereigenschaften

Typ:EndpointAuthenticationOrder
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Certificate

Gibt den Namen des Zertifikats an, das der Endpunkt zum Authentifizieren von Verbindungen verwendet. Der weit entfernte Endpunkt muss über ein Zertifikat mit dem öffentlichen Schlüssel verfügen, der mit dem privaten Schlüssel des Zertifikats übereinstimmt.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Encryption

Gibt die Verschlüsselungsoption für den Endpunkt an. Gültige Werte sind:

  • Arbeitsunfähig
  • Unterstützt
  • Erforderlich

Erforderlich ist der Standardwert.

Parametereigenschaften

Typ:EndpointEncryption
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-EncryptionAlgorithm

Gibt die Vom Endpunkt verwendete Verschlüsselungsform an. Gültige Werte sind:

  • Aes
  • AesRC4
  • Nichts
  • RC4
  • RC4Aes

Standardmäßig verwendet der Endpunkt die Aes-Verschlüsselung.

Der RC4-Algorithmus wird nur aus Gründen der Abwärtskompatibilität unterstützt. Neues Material kann nur mit RC4 oder RC4_128 verschlüsselt werden, wenn sich die Datenbank in Kompatibilitätsebene 90 oder 100 befindet, dies wird jedoch nicht empfohlen. Verwenden Sie für erhöhte Sicherheit stattdessen einen neueren Algorithmus, z. B. einen der AES-Algorithmen.

Parametereigenschaften

Typ:EndpointEncryptionAlgorithm
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-InputObject

Gibt das Serverobjekt der SQL Server-Instanz an, in der der Endpunkt erstellt wird.

Parametereigenschaften

Typ:Server
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByObject
Position:3
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IpAddress

Gibt die IP-Adresse des Endpunkts an. Der Standardwert ist ALL, der angibt, dass der Listener eine Verbindung mit jeder gültigen IP-Adresse akzeptiert.

Parametereigenschaften

Typ:IPAddress
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt den Endpunktnamen an. Dieser Parameter ist erforderlich.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:2
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Owner

Gibt die Anmeldung des Besitzers des Endpunkts an. Standardmäßig ist dies die aktuelle Anmeldung.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Path

Gibt den Pfad zur SQL Server-Instanz des Endpunkts an. Dieser Parameter ist optional. Wenn nicht angegeben, wird der aktuelle Arbeitsort verwendet.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByPath
Position:3
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Port

Gibt den TCP-Port an, auf den der Endpunkt auf Verbindungen lauscht. Der Standardwert ist 5022.

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Script

Gibt an, dass dieses Cmdlet ein Transact-SQL Skript zurückgibt, das die Aufgabe ausführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

SMO.Server

Ausgaben

SMO.Endpoint