Join-SqlAvailabilityGroup
Menggabungkan replika sekunder lokal ke grup ketersediaan.
Sintaks
Join-SqlAvailabilityGroup
[-Name] <String>
[[-Path] <String>]
[-ClusterType <AvailabilityGroupClusterType>]
[-Script]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Join-SqlAvailabilityGroup
[-Name] <String>
[-InputObject] <Server>
[-ClusterType <AvailabilityGroupClusterType>]
[-Script]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
Cmdlet Join-SqlAvailabilityGroup menggabungkan replika sekunder lokal ke grup ketersediaan.
Jalankan cmdlet ini pada instans SQL Server yang menghosting replika sekunder yang tidak bergabung ke grup ketersediaan.
Contoh
Contoh 1: Menggabungkan replika sekunder ke grup ketersediaan
PS C:\> Join-SqlAvailabilityGroup -Path "SQLSERVER:\SQL\SecondaryServer\InstanceName" -Name "MainAG"
Perintah ini menggabungkan replika sekunder ke grup ketersediaan bernama 'MainAG'. Instans server ini harus menghosting replika sekunder dalam grup ketersediaan ini.
Contoh 2: Membuat skrip yang menggabungkan replika sekunder ke grup ketersediaan
PS C:\> Join-SqlAvailabilityGroup -Path "SQLSERVER:\SQL\SecondaryServer\InstanceName" -Name "MainAG" -Script
Perintah ini membuat skrip Transact-SQL yang menggabungkan replika sekunder ke grup ketersediaan bernama 'MainAG'.
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 terhubung ke SQL Azure DB
dan SQL Azure Managed Instance
menggunakan Service Principal
atau Managed Identity
.
Parameter yang akan 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 |
-ClusterType
Jenis kluster yang mendukung AG. Potensi nilai:
- Wsfc. AG akan diintegrasikan di Kluster Failover Windows Server. Ini adalah bagaimana AG pada SQL Server 2016 ke bawah dibuat. Ini adalah default.
- Tidak ada. AG akan independen kluster.
- Eksternal. AG akan dikelola oleh manajer kluster yang bukan Kluster Failover Windows Server, seperti Pacemaker di Linux. Ini didukung pada SQL Server 2017 ke atas. Saat menargetkan SQL Server di Linux, Anda harus menentukan nilai ini atau kesalahan akan terjadi.
Type: | AvailabilityGroupClusterType |
Accepted values: | Wsfc, None, External |
Position: | Named |
Default value: | Wsfc |
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 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 |
-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 server yang menghosting instans SQL Server yang menghosting replika sekunder yang bergabung dengan cmdlet ini ke grup ketersediaan.
Type: | Server |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Menentukan nama grup ketersediaan tempat cmdlet ini bergabung dengan replika sekunder.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Menentukan jalur instans SQL Server yang menghosting replika sekunder yang bergabung dengan cmdlet ini ke grup ketersediaan. Jika Anda tidak menentukan parameter ini, cmdlet ini menggunakan lokasi kerja saat ini.
Type: | String |
Position: | 2 |
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 yang dilakukan cmdlet ini.
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 yang melanggar 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
Anda dapat meneruskan instans server ke cmdlet ini.
Catatan
Layanan pemulihan data ketersediaan tinggi harus diaktifkan pada instans server. Replika ketersediaan yang ditentukan oleh parameter Jalur harus ada.