Bagikan melalui

New-SqlAvailabilityGroup

Modul:
SQLPS Module

Membuat grup ketersediaan.

Sintaks

ByPath (Default) 

New-SqlAvailabilityGroup
    [-Name] <String>
    [[-Path] <String>]
    -AvailabilityReplica <AvailabilityReplica[]>
    [-Database <String[]>]
    [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
    [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
    [-HealthCheckTimeout <Int32>]
    [-BasicAvailabilityGroup]
    [-DatabaseHealthTrigger]
    [-DtcSupportEnabled]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObject 

New-SqlAvailabilityGroup
    [-Name] <String>
    [-InputObject] <Server>
    -AvailabilityReplica <AvailabilityReplica[]>
    [-Database <String[]>]
    [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
    [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
    [-HealthCheckTimeout <Int32>]
    [-BasicAvailabilityGroup]
    [-DatabaseHealthTrigger]
    [-DtcSupportEnabled]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Deskripsi

Cmdlet New-SqlAvailabilityGroup membuat grup ketersediaan di Grup Ketersediaan AlwaysOn. Parameter InputObject atau Path menentukan server yang menghosting replika utama awal.

Contoh

Contoh 1: Membuat grup ketersediaan

PS C:\> $PrimaryServer = Get-Item "SQLSERVER:\SQL\PrimaryServer\Instance22"
PS C:\> $SecondaryServer = Get-Item "SQLSERVER:\SQL\SecondaryServer\Instance22"
PS C:\> $PrimaryReplica = New-SqlAvailabilityReplica -Name "PrimaryServer\Instance22" -EndpointUrl "TCP://PrimaryServer.domain:5022" -FailoverMode "Automatic" -AvailabilityMode "SynchronousCommit" -AsTemplate -Version ($PrimaryServer.Version)
PS C:\> $SecondaryReplica = New-SqlAvailabilityReplica -Name "SecondaryServer\Instance22" -EndpointUrl "TCP://SecondaryServer.domain:5022" -FailoverMode "Automatic" -AvailabilityMode "SynchronousCommit" -AsTemplate -Version ($SecondaryServer.Version)
PS C:\> New-SqlAvailabilityGroup -InputObject $PrimaryServer -Name "MainAG" -AvailabilityReplica ($PrimaryReplica, $SecondaryReplica) -Database @("Database01","Database02")

Perintah pertama mendapatkan instans SQL Server di server utama, lalu menyimpannya dalam variabel $PrimaryServer.

Perintah kedua mendapatkan instans SQL Server di server sekunder, lalu menyimpannya dalam variabel $SecondaryServer.

Perintah ketiga membuat replika yang menyertakan instans server utama dengan menggunakan cmdlet New-SqlAvailabilityReplica , lalu menyimpannya dalam variabel $PrimaryReplica. Perintah menentukan versi instans server dengan menggunakan properti Versi $PrimaryServer.

Perintah keempat membuat replika yang menyertakan instans server sekunder dengan menggunakan New-SqlAvailabilityReplica, lalu menyimpannya dalam variabel $SecondaryReplica. Perintah menentukan versi instans server dengan menggunakan properti Versi $SecondaryServer.

Perintah akhir membuat grup ketersediaan. Ini menentukan nama, server utama, replika, dan informasi lainnya.

Parameter

-AutomatedBackupPreference

Menentukan preferensi pencadangan otomatis untuk grup ketersediaan. Nilai yang dapat diterima untuk parameter ini adalah:

  • Utama. Menentukan bahwa cadangan selalu terjadi pada replika utama. Opsi ini mendukung penggunaan fitur yang tidak tersedia saat pencadangan berjalan pada replika sekunder, seperti cadangan diferensial.
  • SecondaryOnly. Menentukan bahwa cadangan tidak pernah dilakukan pada replika utama. Jika replika utama adalah satu-satunya replika online, pencadangan tidak terjadi.
  • Sekunder. Menentukan bahwa pencadangan terjadi pada replika sekunder, kecuali replika utama adalah satu-satunya replika online. Kemudian pencadangan terjadi pada replika utama.
  • Tidak ada. Menentukan bahwa status primer atau sekunder tidak diperhitungkan saat memutuskan replika mana yang melakukan pencadangan. Sebagai gantinya, prioritas pencadangan dan status online menentukan replika mana yang melakukan pencadangan.

Properti parameter

Jenis:AvailabilityGroupAutomatedBackupPreference
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

-AvailabilityReplica

Menentukan array replika ketersediaan yang disertakan cmdlet ini dalam grup ketersediaan. Untuk mendapatkan objek AvailabilityReplica , gunakan cmdlet New-SqlAvailabilityReplica . Tentukan parameter AsTemplate .

Properti parameter

Jenis:

AvailabilityReplica[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-BasicAvailabilityGroup

Cmdlet New-SqlAvailabilityGroup membuat grup ketersediaan di Grup Ketersediaan AlwaysOn. Parameter InputObject atau Path menentukan server yang menghosting replika utama awal.

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

-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 lokal, baca/tulis. Database ini harus menggunakan model pemulihan penuh dan tidak boleh menggunakan AUTO_CLOSE. Database ini tidak dapat termasuk dalam grup ketersediaan lain dan tidak dapat dikonfigurasi untuk pencerminan database. Anda harus menentukan nilai untuk parameter ini.

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

-DatabaseHealthTrigger

Cmdlet New-SqlAvailabilityGroup membuat grup ketersediaan di Grup Ketersediaan AlwaysOn. Parameter InputObject atau Path menentukan server yang menghosting replika utama awal.

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

-DtcSupportEnabled

Cmdlet New-SqlAvailabilityGroup membuat grup ketersediaan di Grup Ketersediaan AlwaysOn. Parameter InputObject atau Path menentukan server yang menghosting replika utama awal.

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

-FailureConditionLevel

Menentukan perilaku failover otomatis dari grup ketersediaan. Nilai yang dapat diterima untuk parameter ini adalah:

  • OnServerDown. Failover atau mulai ulang jika layanan SQL Server berhenti.
  • OnServerUnresponsive. Failover atau mulai ulang jika ada kondisi nilai yang lebih rendah terpenuhi, ditambah ketika layanan SQL Server terhubung ke kluster dan ambang batas HealthCheckTimeout terlampaui, atau jika replika ketersediaan yang saat ini berada dalam peran utama dalam status gagal.
  • OnCriticalServerError. Failover atau mulai ulang jika ada kondisi nilai yang lebih rendah terpenuhi, ditambah ketika kesalahan Server penting internal terjadi, yang mencakup kondisi memori, pelanggaran akses tulis yang serius, atau terlalu banyak pembuangan.
  • OnModerateServerError. Failover atau mulai ulang jika ada kondisi nilai yang lebih rendah terpenuhi, ditambah jika terjadi kesalahan Server sedang, yang mencakup kondisi memori yang persisten.
  • OnAnyQualifiedFailureConditions. Failover atau mulai ulang jika ada kondisi nilai yang lebih rendah terpenuhi, ditambah jika kondisi kegagalan yang memenuhi syarat terjadi, yang mencakup kelelahan utas pekerja mesin dan kebuntuan yang tidak terselesaikan terdeteksi.

Properti parameter

Jenis:AvailabilityGroupFailureConditionLevel
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

-HealthCheckTimeout

Menentukan lamanya waktu, dalam milidetik, setelah itu grup ketersediaan AlwaysOn menyatakan server yang tidak responsif menjadi tidak sehat.

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

-InputObject

Menentukan instans SQL Server yang menghosting replika utama grup ketersediaan yang dibuat cmdlet ini.

Properti parameter

Jenis:Server
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 grup ketersediaan yang dibuat cmdlet ini.

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 instans SQL Server yang menghosting replika utama awal grup ketersediaan yang dibuat cmdlet ini. Jika Anda tidak menentukan parameter ini, cmdlet ini menggunakan lokasi kerja saat ini. Jika Anda menentukan nilai, jalur saat ini harus ada.

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

-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.

Input

Microsoft.SqlServer.Management.Smo.Server

Anda dapat meneruskan instans server ke cmdlet ini.

Output

Microsoft.SqlServer.Management.Smo.AvailabilityGroup

Cmdlet ini mengembalikan grup ketersediaan.