Bagikan melalui

New-SqlAvailabilityGroupListener

  • Referensi
Modul:
SQLServer

Membuat pendengar grup ketersediaan dan melampirkannya ke grup ketersediaan.

Sintaks

New-SqlAvailabilityGroupListener
   [-DhcpSubnet <String>]
   [-StaticIp <String[]>]
   [-Port <Int32>]
   [-Name] <String>
   [[-Path] <String>]
   [-Script]
   [-AccessToken <PSObject>]
   [-TrustServerCertificate]
   [-HostNameInCertificate <String>]
   [-Encrypt <String>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-SqlAvailabilityGroupListener
   [-DhcpSubnet <String>]
   [-StaticIp <String[]>]
   [-Port <Int32>]
   [-Name] <String>
   [-InputObject] <AvailabilityGroup>
   [-Script]
   [-AccessToken <PSObject>]
   [-TrustServerCertificate]
   [-HostNameInCertificate <String>]
   [-Encrypt <String>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

cmdlet New-SqlAvailabilityGroupListener membuat pendengar grup ketersediaan, dan melampirkannya ke grup ketersediaan. Jalankan cmdlet ini pada instans server yang menghosting replika utama.

Contoh

Contoh 1: Membuat listener untuk grup ketersediaan

PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG"

Perintah ini membuat pendengar grup ketersediaan bernama 'MainListener' untuk grup ketersediaan bernama 'MainAG'. Pendengar ini memperoleh alamat IP virtual dengan menggunakan DHCP. Jalankan perintah ini pada instans server yang menghosting replika utama.

Contoh 2: Membuat listener untuk grup ketersediaan yang memiliki port nondefault

PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -Port 1434

Perintah ini membuat pendengar grup ketersediaan bernama 'MainListener' untuk grup ketersediaan bernama 'MainAG'. Seperti pada contoh sebelumnya, pendengar ini memperoleh alamat IP virtual dengan menggunakan DHCP. Contoh ini menetapkan port 1434 yang didengarkannya.

Contoh 3: Membuat listener untuk grup ketersediaan yang menggunakan DHCP

PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -DhcpSubnet "192.169.0.1/255.255.252.0" -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG"

Perintah ini membuat pendengar grup ketersediaan bernama 'MainListener' untuk grup ketersediaan bernama 'MainAG'. Pendengar ini memperoleh alamat IP virtual di subnet yang ditentukan dengan menggunakan DHCP.

Contoh 4: Membuat listener untuk grup ketersediaan yang menggunakan alamat statis

PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -StaticIp "192.168.3.1/255.255.252.0" -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAG"

Perintah ini membuat pendengar grup ketersediaan bernama 'MainListener' untuk grup ketersediaan bernama 'MainAG'. Pendengar ini menggunakan alamat IPv4 yang ditentukan oleh parameter StaticIp sebagai alamat IP virtualnya.

Contoh 5: Membuat skrip yang membuat pendengar

PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAG" -Script

Perintah ini membuat skrip Transact-SQL yang membuat pendengar grup ketersediaan bernama 'MainListener' untuk grup ketersediaan bernama 'MainAG'. Perintah tidak membuat listener.

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

-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

-DhcpSubnet

Menentukan alamat IPv4 dan subnet mask jaringan. Pendengar menentukan alamat pada jaringan ini dengan menggunakan DHCP. Tentukan alamat dalam untuk format berikut: 192.168.0.1/255.255.255.0.

Jika Anda menentukan parameter ini, jangan tentukan parameter StaticIp .

Jenis:String
Position:Named
Nilai default:None
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

-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 grup ketersediaan, sebagai objek AvailabilityGroup, tempat cmdlet ini melampirkan pendengar.

Jenis:AvailabilityGroup
Position:2
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Name

Menentukan nama untuk pendengar.

Jenis:String
Position:1
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-Path

Menentukan jalur grup ketersediaan tempat cmdlet ini melampirkan pendengar. Jika Anda tidak menentukan parameter ini, cmdlet ini menggunakan lokasi kerja saat ini.

Jenis:String
Position:2
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Port

Menentukan port tempat pendengar mendengarkan koneksi. Port default adalah port TCP 1433.

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 yang dilakukan cmdlet ini.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-StaticIp

Menentukan array alamat. Setiap entri alamat adalah alamat IPv4 dan subnet mask atau alamat IPv6. Pendengar mendengarkan alamat yang ditentukan parameter ini.

Jika Anda menentukan parameter ini, jangan tentukan parameter DhcpSubnet.

Jenis:String[]
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.AvailabilityGroup