New-SqlHADREndpoint

Modul:

SQLPS Module

Membuat titik akhir pencerminan database pada instans SQL Server.

Sintaks

ByPath (Default)

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

Deskripsi

Cmdlet New-SqlHADREndpoint membuat titik akhir pencerminan database pada instans SQL Server. Titik akhir ini diperlukan pada setiap instans server yang menghosting replika ketersediaan untuk grup ketersediaan apa pun. Setiap instans server hanya dapat memiliki satu titik akhir pencerminan database. Jika instans server memiliki titik akhir pencerminan database, gunakan titik akhir yang ada.

Contoh

Contoh 1: Membuat titik akhir pencerminan database

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

Perintah ini membuat titik akhir pencerminan database bernama MainEndpoint pada instans server yang terletak di jalur yang ditentukan. Titik akhir ini menggunakan port default, 5022.

Contoh 2: Membuat titik akhir pencerminan database yang memerlukan enkripsi

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

Perintah ini membuat titik akhir pencerminan database bernama MainEndpoint pada instans server yang terletak di jalur yang ditentukan. Titik akhir ini mendengarkan port 4022. Titik akhir menggunakan algoritma AES untuk enkripsi dan mengharuskan koneksi menggunakan enkripsi.

Contoh 3: Membuat titik akhir pencerminan database yang dienkripsi dengan sertifikat

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

Perintah ini membuat titik akhir pencerminan database bernama MainEndpoint pada instans server yang terletak di jalur yang ditentukan. Titik akhir ini menggunakan sertifikat bernama EncryptionCertificate untuk mengautentikasi koneksi.

Contoh 4: Membuat skrip titik akhir pencerminan database

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

Perintah ini menghasilkan skrip Transact-SQL yang membuat titik akhir pencerminan database bernama MainEndpoint pada instans server yang terletak di jalur yang ditentukan. Titik akhir sebenarnya tidak dibuat oleh perintah ini.

Parameter

-AuthenticationOrder

Menentukan urutan dan jenis autentikasi yang digunakan oleh titik akhir. Nilai yang valid adalah:

• Sertifikat
• CertificateKerberos
• CertificateNegotiate
• CertificateNtlm
• Kerberos
• KerberosCertificate
• Negosiasi
• NegotiateCertificate
• Ntlm
• NtlmCertificate.

Jika opsi yang ditentukan memanggil sertifikat, parameter Sertifikat harus diatur.

Properti parameter

Jenis:	EndpointAuthenticationOrder
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Certificate

Menentukan nama sertifikat yang akan digunakan titik akhir untuk mengautentikasi koneksi. Titik akhir jauh harus memiliki sertifikat dengan kunci publik yang cocok dengan kunci privat sertifikat.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False
Alias:	Cf

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Encryption

Menentukan opsi enkripsi untuk titik akhir. Nilai yang valid adalah:

• Penyandang Disabilitas
• Didukung
• Diperlukan

Diperlukan adalah nilai default.

Properti parameter

Jenis:	EndpointEncryption
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-EncryptionAlgorithm

Menentukan bentuk enkripsi yang digunakan oleh titik akhir. Nilai yang valid adalah:

• Aes
• AesRC4
• Tidak ada
• RC4
• RC4Aes

Secara default titik akhir akan menggunakan enkripsi Aes.

Algoritma RC4 hanya didukung untuk kompatibilitas mundur. Materi baru hanya dapat dienkripsi menggunakan RC4 atau RC4_128 ketika database berada dalam tingkat kompatibilitas 90 atau 100, tetapi ini tidak disarankan. Untuk meningkatkan keamanan, gunakan algoritma yang lebih baru seperti salah satu algoritma AES sebagai gantinya.

Properti parameter

Jenis:	EndpointEncryptionAlgorithm
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-InputObject

Menentukan objek server instans SQL Server tempat titik akhir dibuat.

Properti parameter

Jenis:	Server
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

ByObject

Position:	3
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-IpAddress

Menentukan alamat IP titik akhir. Defaultnya adalah ALL, yang menunjukkan bahwa pendengar menerima koneksi pada alamat IP yang valid.

Properti parameter

Jenis:	IPAddress
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Name

Menentukan nama titik akhir. Parameter ini diperlukan.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	2
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Owner

Menentukan login pemilik titik akhir. Secara default, ini adalah login saat ini.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Path

Menentukan jalur ke instans SQL Server titik akhir. Parameter ini bersifat opsional. Jika tidak ditentukan, lokasi kerja saat ini digunakan.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

ByPath

Position:	3
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Port

Menentukan port TCP tempat titik akhir akan mendengarkan koneksi. Defaultnya adalah 5022.

Properti parameter

Jenis:	Int32
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Script

Menunjukkan bahwa cmdlet ini mengembalikan skrip Transact-SQL yang melakukan tugas.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False
Alias:	wi

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

SMO.Server

Output

SMO.Endpoint

Link Terkait

• Set-SqlHADREndpoint