Add-SqlAvailabilityDatabase
Menambahkan database utama ke grup ketersediaan atau menggabungkan database sekunder ke grup ketersediaan.
Sintaks
ByPath (Default)
Add-SqlAvailabilityDatabase
[[-Path] <String[]>]
-Database <String[]>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Add-SqlAvailabilityDatabase
[-InputObject] <AvailabilityGroup[]>
-Database <String[]>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
Cmdlet Add-SqlAvailabilityDatabase menambahkan database utama ke grup ketersediaan atau menggabungkan database sekunder ke grup ketersediaan. Parameter InputObject atau Path menentukan grup ketersediaan. Database hanya dapat termasuk dalam satu grup ketersediaan.
Untuk menambahkan database ke grup ketersediaan, jalankan cmdlet ini pada instans server yang menghosting replika utama. Tentukan satu atau beberapa database pengguna lokal.
Untuk menggabungkan database sekunder ke grup ketersediaan, siapkan database sekunder secara manual pada instans server yang menghosting replika sekunder. Kemudian jalankan cmdlet ini pada instans server yang menghosting replika sekunder.
Contoh
Contoh 1: Menambahkan database ke grup ketersediaan
PS C:\>Add-SqlAvailabilityDatabase -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -Database "Database16"
Perintah ini menambahkan database Database16 ke grup ketersediaan MainAG. Jalankan perintah ini pada instans server utama grup ketersediaan. Perintah ini tidak menyiapkan database sekunder untuk sinkronisasi data.
Contoh 2: Menggabungkan database ke grup ketersediaan
PS C:\>Add-SqlAvailabilityDatabase -Path "SQLSERVER:\SQL\SecondaryServer\InstanceName\AvailabilityGroups\MainAG" -Database "Database16"
Perintah ini menggabungkan database sekunder bernama Database16 ke grup ketersediaan MainAG pada salah satu instans server yang menghosting replika sekunder.
Contoh 3: Menambahkan database dan menggabungkan database sekunder ke grup ketersediaan
PS C:\> $DatabaseBackupFile = "\\share\backups\Database16.bak"
PS C:\> $LogBackupFile = "\\share\backups\Database16.trn"
PS C:\> $AGPrimaryPath = "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG"
PS C:\> $MyAGSecondaryPath = "SQLSERVER:\SQL\SecondaryServer\InstanceName\AvailabilityGroups\MainAG"
PS C:\> Backup-SqlDatabase -Database "Database16" -BackupFile $DatabaseBackupFile -ServerInstance "PrimaryServer\InstanceName"
PS C:\> Backup-SqlDatabase -Database "Database16" -BackupFile $LogBackupFile -ServerInstance "PrimaryServer\InstanceName" -BackupAction Log
PS C:\> Restore-SqlDatabase -Database "Database16" -BackupFile $DatabaseBackupFile -ServerInstance "SecondaryServer\InstanceName" -NoRecovery
PS C:\> Restore-SqlDatabase -Database "Database16" -BackupFile $LogBackupFile -ServerInstance "SecondaryServer\InstanceName" -RestoreAction Log -NoRecovery
PS C:\> Add-SqlAvailabilityDatabase -Path $AGPrimaryPath -Database 'Database16'
PS C:\> Add-SqlAvailabilityDatabase -Path $AGSecondaryPath -Database "Database16"
Contoh ini menyiapkan database sekunder dari database pada instans server yang menghosting replika utama grup ketersediaan. Ini menambahkan database ke grup ketersediaan sebagai database utama. Terakhir, database sekunder bergabung dengan grup ketersediaan.
Empat perintah pertama menyimpan jalur dalam variabel untuk digunakan nanti dalam contoh. Perintah menetapkan nilai ke variabel $DatabaseBackupFile, $LogBackupFile, $AGPrimaryPath, dan $AGSecondaryPath.
Perintah kelima mencadangkan database bernama Database16 yang ada di server utama ke lokasi di $DatabaseBackupFile.
Perintah keenam mencadangkan file log untuk Database16 di server utama ke lokasi di $LogBackupFile.
Perintah ketujuh memulihkan cadangan database untuk Database16 di server sekunder.
Perintah kedelapan memulihkan file log untuk Database16 di server sekunder.
Perintah kesembilan menambahkan database ke grup ketersediaan di server utama.
Perintah akhir menggabungkan database sekunder untuk replika tersebut ke grup ketersediaan. Jika Anda memiliki lebih dari satu replika sekunder, pulihkan dan gabungkan database sekunder untuk masing-masing replika tersebut.
Contoh 4: Membuat skrip untuk menambahkan database ke grup ketersediaan
PS C:\>Add-SqlAvailabilityDatabase -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -Database "Database16" -Script
Perintah ini membuat skrip Transact-SQL yang menambahkan database Database16 ke grup ketersediaan MainAG.
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 |
-Database
Menentukan array database pengguna. Cmdlet ini menambahkan atau menggabungkan database yang ditentukan parameter ini ke grup ketersediaan. Database yang Anda tentukan harus berada di instans lokal SQL Server.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-InputObject
Menentukan grup ketersediaan, sebagai objek AvailabilityGroup , tempat cmdlet ini menambahkan atau menggabungkan database.
Properti parameter
| Jenis: | AvailabilityGroup[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
ByObject
| Position: | 2 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Path
Menentukan jalur grup ketersediaan tempat cmdlet ini menambahkan atau menggabungkan database. 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: | 2 |
| 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 |
-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.