Share via

New-SqlHADREndpoint

  • Referensi
Modul:
SQLServer

Membuat titik akhir pencerminan database pada instans SQL Server.

Sintaks

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>]
   [-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>]
   [-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 di port 4022. Titik akhir menggunakan AES algoritma 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

-AccessToken

Token akses yang digunakan untuk mengautentikasi ke SQL Server, sebagai alternatif untuk pengguna/kata sandi atau Autentikasi Windows.

Ini dapat digunakan, misalnya, untuk menyambungkan ke SQL Azure DB dan SQL Azure Managed Instance menggunakan Service Principal atau Managed Identity.

Parameter yang digunakan dapat berupa string yang mewakili token atau objek seperti yang PSAccessToken dikembalikan dengan menjalankan Get-AzAccessToken -ResourceUrl https://database.windows.net.

Parameter ini baru dalam v22 modul.

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

-AuthenticationOrder

Menentukan urutan dan jenis autentikasi yang digunakan oleh titik akhir.

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

Type:EndpointAuthenticationOrder
Accepted values:Ntlm, Kerberos, Negotiate, Certificate, NtlmCertificate, KerberosCertificate, NegotiateCertificate, CertificateNtlm, CertificateKerberos, CertificateNegotiate
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-Encrypt

Jenis enkripsi yang digunakan saat menyambungkan ke SQL Server.

Nilai ini memetakan ke Encrypt properti SqlConnectionEncryptOption pada objek SqlConnection dari driver Microsoft.Data.SqlClient.

Dalam v22 modul, defaultnya adalah Optional (untuk kompatibilitas dengan v21). Dalam v23+ modul, nilai defaultnya adalah 'Wajib', yang dapat membuat perubahan yang melanggar untuk skrip yang ada.

Parameter ini baru dalam v22 modul.

Type:String
Accepted values:Mandatory, Optional, Strict
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Encryption

Menentukan opsi enkripsi untuk titik akhir.

Nilai defaultnya adalah Required.

Type:EndpointEncryption
Accepted values:Disabled, Supported, Required
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EncryptionAlgorithm

Menentukan bentuk enkripsi yang digunakan oleh titik akhir.

Secara default titik akhir akan menggunakan enkripsi Aes.

CATATAN: 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 AES satu algoritma sebagai gantinya.

Type:EndpointEncryptionAlgorithm
Accepted values:None, RC4, Aes, AesRC4, RC4Aes
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HostNameInCertificate

Nama host yang akan digunakan dalam memvalidasi sertifikat TLS/SSL SQL Server. Anda harus meneruskan parameter ini jika instans SQL Server Anda diaktifkan untuk Enkripsi Paksa dan Anda ingin terhubung ke instans menggunakan nama host/nama pendek. Jika parameter ini dihilangkan, maka meneruskan Nama Domain yang Sepenuhnya Memenuhi Syarat (FQDN) ke -ServerInstance diperlukan untuk terhubung ke instans SQL Server yang diaktifkan untuk Enkripsi Paksa.

Parameter ini baru dalam v22 modul.

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

-InputObject

Menentukan objek server instans SQL Server tempat titik akhir dibuat.

Type:Server
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-IpAddress

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

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

-Name

Menentukan nama titik akhir.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Owner

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

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

-Path

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

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Port

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

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

-Script

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

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

-TrustServerCertificate

Menunjukkan apakah saluran akan dienkripsi saat melewati rantai sertifikat untuk memvalidasi kepercayaan.

Dalam v22 modul, defaultnya adalah $true (untuk kompatibilitas dengan v21). Dalam v23+ modul, nilai defaultnya adalah '$false', yang dapat membuat perubahan mencolok untuk skrip yang ada.

Parameter ini baru dalam v22 modul.

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

-WhatIf

Menunjukkan yang akan terjadi jika cmdlet dijalankan. Cmdlet tidak dijalankan.

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

Input

Microsoft.SqlServer.Management.Smo.Server

Output

SMO.Endpoint