New-SqlHADREndpoint

Модуль:

SQLServer

Создает конечную точку зеркального отображения базы данных в экземпляре SQL Server.

Синтаксис

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

Описание

Командлет New-SqlHADREndpoint создает конечную точку зеркального отображения базы данных в экземпляре 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 зеркального отображения базы данных на экземпляре сервера, расположенном по указанному пути. Конечная точка этой командой фактически не создается.

Параметры

-AccessToken

Маркер доступа, используемый для проверки подлинности для SQL Server, в качестве альтернативы проверке подлинности пользователя или пароля или проверки подлинности Windows.

Его можно использовать, например, для подключения к SQL Azure DB и SQL Azure Managed Instance с помощью Service Principal или Managed Identity.

Используемый параметр может быть либо строкой, представляющей маркер, либо объектом, PSAccessToken возвращаемым при выполнении команды Get-AzAccessToken -ResourceUrl https://database.windows.net.

Этот параметр является новым в версии 22 модуля.

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

-AuthenticationOrder

Указывает порядок и тип проверки подлинности, используемой конечной точкой.

Если указанный параметр вызывает сертификат, необходимо задать параметр Certificate.

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

Указывает имя сертификата, который конечная точка будет использовать для проверки подлинности подключений. Дальней конечной точке должен быть сертификат с открытым ключом, соответствующим закрытому ключу сертификата.

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

-Confirm

Запрос подтверждения перед выполнением командлета.

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

-Encrypt

Тип шифрования, используемый при подключении к SQL Server.

Это значение сопоставляется со свойством EncryptSqlConnectionEncryptOption объекта SqlConnection драйвера Microsoft.Data.SqlClient.

В модуле версии 22 значение по умолчанию — Optional (для совместимости с версией 21). В версии 23 и более поздних версий модуля значением по умолчанию будет "Обязательно", что может привести к критическому изменению для существующих скриптов.

Этот параметр является новым в версии 22 модуля.

Type:	String
Accepted values:	Mandatory, Optional, Strict
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Encryption

Задает параметр шифрования для конечной точки.

Значение по умолчанию — Required.

Type:	EndpointEncryption
Accepted values:	Disabled, Supported, Required
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionAlgorithm

Указывает форму шифрования, используемую конечной точкой.

По умолчанию для конечной точки используется шифрование AES.

ПРИМЕЧАНИЕ. Алгоритм RC4 поддерживается только для обеспечения обратной совместимости. Новый материал можно зашифровать с помощью rc4 или RC4_128, если база данных находится на уровне совместимости 90 или 100, но это не рекомендуется. Для повышения безопасности используйте более новый алгоритм, например один из алгоритмов AES .

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

Имя узла используется для проверки TLS/SSL-сертификата SQL Server. Этот параметр необходимо передать, если экземпляр SQL Server включен для принудительного шифрования и вы хотите подключиться к экземпляру с помощью имени узла или shortname. Если этот параметр опущен, необходимо передать полное доменное имя (FQDN) в -ServerInstance для подключения к экземпляру SQL Server, включенного для принудительного шифрования.

Этот параметр является новым в версии 22 модуля.

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

-InputObject

Указывает объект сервера экземпляра SQL Server, в котором создается конечная точка.

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

-IpAddress

Указывает IP-адрес конечной точки. Значение по умолчанию — ALL, указывающее, что прослушиватель принимает подключение по любому допустимому IP-адресу.

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

-Name

Указывает имя конечной точки.

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

-Owner

Указывает имя входа владельца конечной точки. По умолчанию используется текущее имя входа.

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

-Path

Указывает путь к экземпляру SQL Server конечной точки. Если значение не указано, используется текущее рабочее расположение.

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

-Port

Указывает TCP-порт, на котором конечная точка будет прослушивать подключения. Значение по умолчанию — 5022.

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

-Script

Указывает, что этот командлет возвращает скрипт Transact-SQL, который выполняет задачу.

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

-TrustServerCertificate

Указывает, будет ли канал зашифрован при обходе цепочки сертификатов для проверки доверия.

В модуле версии 22 значение по умолчанию — $true (для совместимости с версией 21). В модуле версии 23+ значение по умолчанию будет "$false", что может привести к критическому изменению для существующих скриптов.

Этот параметр является новым в версии 22 модуля.

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

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

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

Входные данные

Microsoft.SqlServer.Management.Smo.Server

Выходные данные

SMO.Endpoint

Связанные ссылки

• Set-SqlHADREndpoint