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>]
   [-ProgressAction <ActionPreference>]
   [-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>]
   [-ProgressAction <ActionPreference>]
   [-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 модуля.

Тип:	PSObject
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-AuthenticationOrder

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

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

Тип:	EndpointAuthenticationOrder
Допустимые значения:	Ntlm, Kerberos, Negotiate, Certificate, NtlmCertificate, KerberosCertificate, NegotiateCertificate, CertificateNtlm, CertificateKerberos, CertificateNegotiate
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Certificate

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

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Encrypt

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

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

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

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

Тип:	String
Допустимые значения:	Mandatory, Optional, Strict
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Encryption

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

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

Тип:	EndpointEncryption
Допустимые значения:	Disabled, Supported, Required
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-EncryptionAlgorithm

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

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

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

Тип:	EndpointEncryptionAlgorithm
Допустимые значения:	None, RC4, Aes, AesRC4, RC4Aes
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-HostNameInCertificate

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

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

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-InputObject

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

Тип:	Server
Position:	2
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-IpAddress

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

Тип:	IPAddress
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Name

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

Тип:	String
Position:	1
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Owner

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

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Path

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

Тип:	String
Position:	2
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Port

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

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ProgressAction

Определяет, как PowerShell реагирует на обновления хода выполнения, созданные скриптом, командлетом или поставщиком, например индикаторами хода выполнения, созданными командлетом Write-Progress. Командлет Write-Progress создает индикаторы хода выполнения, показывающие состояние команды.

Тип:	ActionPreference
Aliases:	proga
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Script

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-TrustServerCertificate

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

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

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-WhatIf

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

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

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

Microsoft.SqlServer.Management.Smo.Server

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

SMO.Endpoint

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

• Set-SqlHADREndpoint