New-SqlHADREndpoint
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>]
[-ProgressAction <ActionPreference>]
[-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>]
[-ProgressAction <ActionPreference>]
[-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 RequiredPerintah 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" -ScriptPerintah 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 PSAccessToken seperti yang dikembalikan dengan menjalankan Get-AzAccessToken -ResourceUrl https://database.windows.net.
Parameter ini baru dalam v22 modul.
| Jenis: | PSObject |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-AuthenticationOrder
Menentukan urutan dan jenis autentikasi yang digunakan oleh titik akhir.
Jika opsi yang ditentukan memanggil sertifikat, parameter Sertifikat harus diatur.
| Jenis: | EndpointAuthenticationOrder |
| Nilai yang diterima: | Ntlm, Kerberos, Negotiate, Certificate, NtlmCertificate, KerberosCertificate, NegotiateCertificate, CertificateNtlm, CertificateKerberos, CertificateNegotiate |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | 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.
| Jenis: | String |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-Confirm
Meminta konfirmasi sebelum menjalankan cmdlet.
| Jenis: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Nilai default: | False |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-Encrypt
Jenis enkripsi yang akan digunakan saat menyambungkan ke SQL Server.
Nilai ini memetakan ke properti EncryptSqlConnectionEncryptOption pada objek SqlConnection 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.
| Jenis: | String |
| Nilai yang diterima: | Mandatory, Optional, Strict |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-Encryption
Menentukan opsi enkripsi untuk titik akhir.
Nilai defaultnya adalah Required.
| Jenis: | EndpointEncryption |
| Nilai yang diterima: | Disabled, Supported, Required |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | 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 satu algoritma AES sebagai gantinya.
| Jenis: | EndpointEncryptionAlgorithm |
| Nilai yang diterima: | None, RC4, Aes, AesRC4, RC4Aes |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-HostNameInCertificate
Nama host yang akan digunakan dalam memvalidasi sertifikat SQL Server TLS/SSL. 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.
| Jenis: | String |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-InputObject
Menentukan objek server instans SQL Server tempat titik akhir dibuat.
| Jenis: | Server |
| Position: | 2 |
| Nilai default: | None |
| Diperlukan: | True |
| Terima input alur: | True |
| Terima karakter wildcard: | False |
-IpAddress
Menentukan alamat IP titik akhir. Defaultnya adalah ALL, yang menunjukkan bahwa pendengar menerima koneksi pada alamat IP yang valid.
| Jenis: | IPAddress |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-Name
Menentukan nama titik akhir.
| Jenis: | String |
| Position: | 1 |
| Nilai default: | None |
| Diperlukan: | True |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-Owner
Menentukan login pemilik titik akhir. Secara default, ini adalah login saat ini.
| Jenis: | String |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-Path
Menentukan jalur ke instans SQL Server titik akhir. Jika tidak ditentukan, lokasi kerja saat ini digunakan.
| Jenis: | String |
| Position: | 2 |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-Port
Menentukan port TCP tempat titik akhir akan mendengarkan koneksi.
Defaultnya adalah 5022.
| Jenis: | Int32 |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-ProgressAction
Menentukan bagaimana PowerShell merespons pembaruan kemajuan yang dihasilkan oleh skrip, cmdlet, atau penyedia, seperti bilah kemajuan yang dihasilkan oleh cmdlet Write-Progress. cmdlet Write-Progress membuat bilah kemajuan yang memperlihatkan status perintah.
| Jenis: | ActionPreference |
| Alias: | proga |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-Script
Menunjukkan bahwa cmdlet ini mengembalikan skrip Transact-SQL yang melakukan tugas.
| Jenis: | SwitchParameter |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | 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 yang melanggar untuk skrip yang ada.
Parameter ini baru dalam v22 modul.
| Jenis: | SwitchParameter |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-WhatIf
Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.
| Jenis: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Nilai default: | False |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
Input
Microsoft.SqlServer.Management.Smo.Server
Output
SMO.Endpoint