Share via

New-SqlHADREndpoint

  • 참조
모듈:
SQLPS

SQL Server instance 데이터베이스 미러링 엔드포인트를 만듭니다.

Syntax

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

Description

New-SqlHADREndpoint cmdlet은 SQL Server instance 데이터베이스 미러링 엔드포인트를 만듭니다. 이 엔드포인트는 모든 가용성 그룹에 대한 가용성 복제본을 호스팅하는 모든 서버 인스턴스에 필요합니다. 각 서버 인스턴스에는 하나의 데이터베이스 미러링 엔드포인트가 있어야 합니다. 서버 instance 데이터베이스 미러링 엔드포인트가 있는 경우 기존 엔드포인트를 사용합니다.

예제

예제 1: 데이터베이스 미러링 엔드포인트 만들기

PS C:\> New-SqlHADREndpoint -Path "SQLSERVER:\Sql\Computer\Instance" -Name "MainEndpoint"

이 명령은 지정된 경로에 있는 서버 instance MainEndpoint라는 데이터베이스 미러링 엔드포인트를 만듭니다. 이 엔드포인트는 기본 포트인 5022를 사용합니다.

예제 2: 암호화가 필요한 데이터베이스 미러링 엔드포인트 만들기

PS C:\> New-SqlHADREndpoint -Path "SQLSERVER:\Sql\Computer\Instance" -Name "MainEndpoint" -Port 4022 -EncryptionAlgorithm Aes' -Encryption Required

이 명령은 지정된 경로에 있는 서버 instance MainEndpoint라는 데이터베이스 미러링 엔드포인트를 만듭니다. 이 엔드포인트는 포트 4022에서 수신 대기합니다. 이 엔드포인트는 암호화에 AES 알고리즘을 사용하며 연결 시 암호화를 사용해야 합니다.

예제 3: 인증서로 암호화된 데이터베이스 미러링 엔드포인트 만들기

PS C:\> New-SqlHADREndpoint -Path "SQLSERVER:\Sql\Computer\Instance" -Name "MainEndpoint" -AuthenticationOrder 
Certificate -Certificate "EncryptionCertificate"

이 명령은 지정된 경로에 있는 서버 instance MainEndpoint라는 데이터베이스 미러링 엔드포인트를 만듭니다. 이 엔드포인트는 EncryptionCertificate라는 인증서를 사용하여 연결을 인증합니다.

예제 4: 데이터베이스 미러링 엔드포인트 스크립트 만들기

PS C:\> New-SqlHADREndpoint -Path "SQLSERVER:\Sql\Computer\Instance" -Name "MainEndpoint" -Script

이 명령은 지정된 경로에 있는 서버 instance MainEndpoint라는 데이터베이스 미러링 엔드포인트를 만드는 Transact-SQL 스크립트를 출력합니다. 이 명령으로 엔드포인트가 실제로 만들어지는 것은 아닙니다.

매개 변수

-AuthenticationOrder

엔드포인트에서 사용되는 인증의 순서와 유형을 지정합니다. 유효한 값은 다음과 같습니다.

  • 인증서
  • CertificateKerberos
  • CertificateNegotiate
  • CertificateNtlm
  • Kerberos
  • KerberosCertificate
  • Negotiate
  • NegotiateCertificate
  • Ntlm
  • NtlmCertificate.

지정된 옵션이 인증서를 호출하는 경우 Certificate 매개 변수를 설정해야 합니다.

Type:EndpointAuthenticationOrder
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

cmdlet을 실행하기 전에 확인을 요청합니다.

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

-Encryption

엔드포인트에 대한 암호화 옵션을 지정합니다. 유효한 값은 다음과 같습니다.

  • 사용 안 함
  • 지원됨
  • 필수

Required가 기본값입니다.

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

-EncryptionAlgorithm

엔드포인트에서 사용하는 암호화 형식을 지정합니다. 유효한 값은 다음과 같습니다.

  • Aes
  • AesRC4
  • 없음
  • RC4
  • RC4Aes

기본적으로 엔드포인트는 Aes 암호화를 사용합니다.

RC4 알고리즘은 이전 버전과의 호환성을 위해서만 지원됩니다. 새 자료는 데이터베이스가 호환성 수준 90 또는 100인 경우에만 RC4 또는 RC4_128 사용하여 암호화할 수 있지만 권장되지 않습니다. 보안을 강화하려면 AES 알고리즘 중 하나와 같은 최신 알고리즘을 대신 사용합니다.

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

-InputObject

엔드포인트가 만들어지는 SQL Server instance 서버 개체를 지정합니다.

Type:Server
Position:3
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:2
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 instance 경로를 지정합니다. 이 매개 변수는 선택적 요소입니다. 지정하지 않으면 현재 작업 위치가 사용됩니다.

Type:String
Position:3
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

이 cmdlet이 작업을 수행하는 Transact-SQL 스크립트를 반환한다는 것을 나타냅니다.

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

-WhatIf

cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet은 실행되지 않습니다.

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

입력

SMO.Server

출력

SMO.Endpoint