New-SqlAvailabilityGroupListener
Membuat pendengar grup ketersediaan dan melampirkannya ke grup ketersediaan.
Sintaks
ByPath (Default)
New-SqlAvailabilityGroupListener
[-Name] <String>
[[-Path] <String>]
[-DhcpSubnet <String>]
[-StaticIp <String[]>]
[-Port <Int32>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
New-SqlAvailabilityGroupListener
[-Name] <String>
[-InputObject] <AvailabilityGroup>
[-DhcpSubnet <String>]
[-StaticIp <String[]>]
[-Port <Int32>]
[-Script]
[-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 listener 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 non-default
PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -Port 1434
Perintah ini membuat listener 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 listener 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 listener 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
-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 |
-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 .
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 |
-InputObject
Menentukan grup ketersediaan, sebagai objek AvailabilityGroup , tempat cmdlet ini melampirkan pendengar.
Properti parameter
| Jenis: | AvailabilityGroup |
| 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 |
-Name
Menentukan nama untuk pendengar.
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 |
-Path
Menentukan jalur grup ketersediaan tempat cmdlet ini melampirkan pendengar. Jika Anda tidak menentukan parameter ini, cmdlet ini menggunakan lokasi kerja saat ini.
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 tempat pendengar mendengarkan koneksi. Port default adalah port TCP 1433.
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 yang dilakukan cmdlet ini.
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 |
-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 .
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 |
-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.