Поделиться через

New-SqlHADREndpoint

  • Ссылка
Модуль:
SQLPS

Создает конечную точку зеркального отображения базы данных в экземпляре 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>]

Описание

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

Параметры

-AuthenticationOrder

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

  • Сертификат
  • CertificateKerberos
  • CertificateNegotiate
  • CertificateNtlm
  • Kerberos
  • KerberosCertificate
  • Согласование
  • NegotiateCertificate
  • Ntlm
  • NtlmCertificate.

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

Тип:EndpointAuthenticationOrder
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

-Encryption

Задает параметр шифрования для конечной точки. Допустимые значения:

  • Выключено
  • Поддерживается
  • Обязательно

Значением по умолчанию является Required.

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

-EncryptionAlgorithm

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

  • Aes
  • AesRC4
  • Нет
  • RC4;
  • RC4Aes

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

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

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

-InputObject

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

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

-IpAddress

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

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

-Name

Указывает имя конечной точки. Это обязательный параметр.

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

-Owner

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

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

-Path

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

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

-Port

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

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

-Script

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

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

-WhatIf

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

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

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

SMO.Server

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

SMO.Endpoint