Set-SqlHADREndpoint

设置数据库镜像终结点的属性。

语法

Set-SqlHADREndpoint
   [-Owner <String>]
   [-Certificate <String>]
   [-IpAddress <IPAddress>]
   [-AuthenticationOrder <EndpointAuthenticationOrder>]
   [-Encryption <EndpointEncryption>]
   [-EncryptionAlgorithm <EndpointEncryptionAlgorithm>]
   [-Port <Int32>]
   [-State <EndpointState>]
   [[-Path] <String>]
   [-Script]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SqlHADREndpoint
   [-Owner <String>]
   [-Certificate <String>]
   [-IpAddress <IPAddress>]
   [-AuthenticationOrder <EndpointAuthenticationOrder>]
   [-Encryption <EndpointEncryption>]
   [-EncryptionAlgorithm <EndpointEncryptionAlgorithm>]
   [-Port <Int32>]
   [-State <EndpointState>]
   [-InputObject] <Endpoint>
   [-Script]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-SqlHADREndpoint cmdlet 更改数据库镜像终结点的属性。

示例

示例 1:设置数据库镜像终结点的端口号

PS C:\> Set-SqlHADREndpoint -Path "SQLSERVER:\Sql\Computer\Instance\Endpoints\MainDbmEndpoint" -Port 5050

此命令将名为 MainDbmEndpoint 的数据库镜像终结点的端口号设置为名为 Computer\Instance 的服务器实例上的 5050。

示例 2:启动数据库镜像终结点

PS C:\> Set-SqlHADREndpoint -Path "SQLSERVER:\Sql\Computer\Instance\Endpoints\MainDbmEndpoint" -State Started

此命令在服务器实例 Computer\Instance 上启动名为 MainDbmEndpoint 的数据库镜像终结点。

参数

-AuthenticationOrder

指定终结点使用的身份验证的顺序和类型。 . 如果指定的选项调用证书,则必须设置 Certificate 参数,除非证书已与终结点关联。 有效值为:

  • 证书
  • CertificateKerberos
  • CertificateNegotiate
  • CertificateNtlm
  • Kerberos
  • KerberosCertificate
  • Negotiate
  • NegotiateCertificate
  • Ntlm
  • NtlmCertificate
类型: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

指定终结点加密设置。 有效值为:

  • 已禁用
  • 支持
  • 必需
类型:EndpointEncryption
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EncryptionAlgorithm

指定终结点使用的加密形式。 有效值为:

  • Aes
  • AesRC4
  • RC4
  • RC4Aes

RC4 算法仅用于支持向后兼容性。 仅当数据库处于兼容性级别 90 或 100 时,才能使用 RC4 或 RC4_128 加密新材料,但不建议这样做。 为了提高安全性,请改用较新的算法,例如其中一种 AES 算法。

类型:EndpointEncryptionAlgorithm
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InputObject

指定要修改的终结点。 该端点必须是数据库镜像端点。

类型:Endpoint
Position:2
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-IpAddress

指定终结点将侦听的 IP 地址。

类型:IPAddress
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Owner

指定终结点的所有者。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Path

指定数据库镜像终结点的路径。 这是一个可选参数。 如果未指定,则使用当前工作位置。

类型:String
Position:2
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Port

指定终结点用于侦听连接的 TCP 端口号。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Script

指示此 cmdlet 输出执行任务的 Transact-SQL 脚本。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-State

指定终结点的状态。 有效值为:

  • 已开始
  • 已停止
  • 已禁用
类型:EndpointState
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 此 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

SMO.Endpoint

输出

SMO.Endpoint