New-SqlHADREndpoint

Модуль:

SQLPS Module

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

Синтаксис

ByPath (по умолчанию)

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

ByObject

New-SqlHADREndpoint
    [-Name] <String>
    [-InputObject] <Server>
    [-Port <Int32>]
    [-Owner <String>]
    [-Certificate <String>]
    [-IpAddress <IPAddress>]
    [-AuthenticationOrder <EndpointAuthenticationOrder>]
    [-Encryption <EndpointEncryption>]
    [-EncryptionAlgorithm <EndpointEncryptionAlgorithm>]
    [-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
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Certificate

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

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Confirm

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

Свойства параметра

Тип:	SwitchParameter
Default value:	False
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	cf

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Encryption

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

• Нетрудоспособный
• Поддерживается
• Обязательно

Обязательный — это значение по умолчанию.

Свойства параметра

Тип:	EndpointEncryption
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-EncryptionAlgorithm

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

• Aes
• AesRC4
• Отсутствует
• RC4;
• RC4Aes

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

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

Свойства параметра

Тип:	EndpointEncryptionAlgorithm
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-InputObject

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

Свойства параметра

Тип:	Server
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByObject

Position:	3
Обязательно:	True
Значение из конвейера:	True
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-IpAddress

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

Свойства параметра

Тип:	IPAddress
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Name

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

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	2
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Owner

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

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Path

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

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByPath

Position:	3
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Port

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

Свойства параметра

Тип:	Int32
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Script

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

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-WhatIf

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

Свойства параметра

Тип:	SwitchParameter
Default value:	False
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	wi

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

SMO.Server

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

SMO.Endpoint

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

• Set-SqlHADREndpoint