共用方式為


New-SqlHADREndpoint

在 SQL Server 實例上建立資料庫鏡像端點。

語法

New-SqlHADREndpoint
   [-Port <Int32>]
   [-Owner <String>]
   [-Certificate <String>]
   [-IpAddress <IPAddress>]
   [-AuthenticationOrder <EndpointAuthenticationOrder>]
   [-Encryption <EndpointEncryption>]
   [-EncryptionAlgorithm <EndpointEncryptionAlgorithm>]
   [-Name] <String>
   [[-Path] <String>]
   [-Script]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-SqlHADREndpoint
   [-Port <Int32>]
   [-Owner <String>]
   [-Certificate <String>]
   [-IpAddress <IPAddress>]
   [-AuthenticationOrder <EndpointAuthenticationOrder>]
   [-Encryption <EndpointEncryption>]
   [-EncryptionAlgorithm <EndpointEncryptionAlgorithm>]
   [-Name] <String>
   [-InputObject] <Server>
   [-Script]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-SqlHADREndpoint Cmdlet 會在 SQL Server 實例上建立資料庫鏡像端點。 裝載任何可用性群組之可用性複本的每個伺服器執行個體都需要這個端點。 每個伺服器執行個體只能有一個資料庫鏡像端點。 如果伺服器實例擁有資料庫鏡像端點,請使用現有的端點。

範例

範例 1:建立資料庫鏡像端點

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

此命令會在位於指定路徑的伺服器實例上建立名為MainEndpoint的資料庫鏡像端點。 此端點會使用預設通訊埠 5022。

範例 2:建立需要加密的資料庫鏡像端點

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

此命令會在位於指定路徑的伺服器實例上建立名為MainEndpoint的資料庫鏡像端點。 此端點會接聽埠 4022。 此端點會使用 AES 演算法進行加密,並且要求連接使用加密。

範例 3:建立使用憑證加密的資料庫鏡像端點

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

此命令會在位於指定路徑的伺服器實例上建立名為MainEndpoint的資料庫鏡像端點。 此端點會使用名為 EncryptionCertificate 的憑證來驗證連線。

範例 4:建立資料庫鏡像端點腳本

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

此命令會輸出 Transact-SQL 腳本,以在位於指定路徑的伺服器實例上建立名為 MainEndpoint 的資料庫鏡像端點。 此命令實際上不會建立端點。

參數

-AuthenticationOrder

指定端點所使用的驗證順序和類型。 有效值為:

  • 憑證
  • CertificateKerberos
  • CertificateNegotiate
  • CertificateNtlm
  • Kerberos
  • KerberosCertificate
  • 交涉
  • NegotiateCertificate
  • Ntlm
  • NtlmCertificate。

如果指定的選項呼叫憑證,則必須設定 Certificate 參數。

類型:EndpointAuthenticationOrder
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Certificate

指定端點將用來驗證連線的憑證名稱。 遠方端點必須具有符合憑證私鑰的公鑰的憑證。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Confirm

在執行 Cmdlet 前提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Encryption

指定端點的加密選項。 有效值為:

  • 已停用
  • 支援
  • 必要

Required 是預設值。

類型:EndpointEncryption
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-EncryptionAlgorithm

指定端點所使用的加密形式。 有效值為:

  • Aes
  • AesRC4
  • RC4
  • RC4Aes

根據預設,端點將使用 Aes 加密。

只有 RC4 演算法支援回溯相容性。 當資料庫處於相容性層級 90 或 100 時,只能使用 RC4 或RC4_128來加密新數據,但不建議這麼做。 為了提高安全性,請改用較新的演算法,例如其中一個 AES 演算法。

類型:EndpointEncryptionAlgorithm
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-InputObject

指定建立端點之 SQL Server 實例的伺服器物件。

類型:Server
Position:3
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-IpAddress

指定端點的IP位址。 默認值為 ALL,表示接聽程式接受任何有效 IP 位址上的連線。

類型:IPAddress
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Name

指定端點名稱。 此為必要參數。

類型:String
Position:2
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Owner

指定端點擁有者的登入。 根據預設,這是目前登入。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Path

指定端點 SQL Server 實體的路徑。 這是選擇性參數。 如果未指定,則會使用目前的工作位置。

類型:String
Position:3
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Port

指定端點將接聽連線的 TCP 連接埠。 預設值為 5022。

類型:Int32
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Script

表示此 Cmdlet 會傳回執行工作的 Transact-SQL 腳本。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

SMO.Server

輸出

SMO.Endpoint