New-SqlAvailabilityReplica
Membuat replika ketersediaan.
Sintaks
ByPath (Default)
New-SqlAvailabilityReplica
[-Name] <String>
[[-Path] <String>]
-AvailabilityMode <AvailabilityReplicaAvailabilityMode>
-FailoverMode <AvailabilityReplicaFailoverMode>
-EndpointUrl <String>
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
AsTemplate
New-SqlAvailabilityReplica
[-Name] <String>
-AvailabilityMode <AvailabilityReplicaAvailabilityMode>
-FailoverMode <AvailabilityReplicaFailoverMode>
-EndpointUrl <String>
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-AsTemplate]
[-Version <ServerVersion>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
New-SqlAvailabilityReplica
[-Name] <String>
[-InputObject] <AvailabilityGroup>
-AvailabilityMode <AvailabilityReplicaAvailabilityMode>
-FailoverMode <AvailabilityReplicaFailoverMode>
-EndpointUrl <String>
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
Cmdlet New-SqlAvailabilityReplica membuat replika ketersediaan. Jalankan cmdlet ini pada instans SQL Server yang menghosting replika utama.
Untuk membuat replika ketersediaan sebelum Anda membuat grup ketersediaan, tentukan parameter AsTemplate . Untuk menambahkan replika ke grup ketersediaan yang ada, parameter InputObject atau Path menentukan grup ketersediaan.
Contoh
Contoh 1: Membuat representasi replika ketersediaan
PS C:\> $ServerObject = Get-Item "SQLSERVER:\Sql\PrimaryServer\InstanceName"
PS C:\> New-SqlAvailabilityReplica -Name "PrimaryServer\Instance" -EndpointUrl "TCP://PrimaryServerName.domain.com:5022" -FailoverMode Automatic -AvailabilityMode SynchronousCommit -AsTemplate -Version $ServerObject.Version
Contoh ini membuat representasi dalam memori dari replika ketersediaan. Tidak ada perubahan yang diterapkan pada server. Anda dapat menggunakan replika ini sebagai nilai untuk parameter AvailabilityReplica dari New-SqlAvailabilityGroup
Perintah pertama mendapatkan instans server utama.
Perintah kedua membuat replika ketersediaan. Replika ini menggunakan titik akhir pencerminan database yang terletak di URL yang ditentukan untuk berkomunikasi dengan replika lain dalam grup ketersediaan. Replika ini mendukung failover otomatis dan mode ketersediaan penerapan sinkron. Parameter Versi menentukan versi instans server yang akan menghosting replika baru ini.
Contoh 2: Membuat replika ketersediaan yang mendukung failover manual dan penerapan asinkron
PS C:\> $ServerObject = Get-Item "SQLSERVER:\Sql\PrimaryServer\InstanceName"
PS C:\> New-SqlAvailabilityReplica -Name "SecondaryServer\Instance" -EndpointUrl "TCP://PrimaryServerName.domain.com:5022" -FailoverMode Manual -AvailabilityMode AsynchronousCommit -AsTemplate -Version $ServerObject.Version
Contoh ini membuat representasi dalam memori dari replika ketersediaan. Tidak ada perubahan yang diterapkan pada server.
Perintah pertama mendapatkan instans server utama.
Perintah kedua membuat replika ketersediaan. Replika ini menggunakan titik akhir pencerminan database yang terletak di URL yang ditentukan untuk berkomunikasi dengan replika lain dalam grup ketersediaan. Replika ini mendukung failover manual dan mode ketersediaan penerapan asinkron. Parameter Versi menentukan versi instans server yang akan menghosting replika baru ini.
Contoh 3: Menambahkan replika ketersediaan ke grup ketersediaan
PS C:\> New-SqlAvailabilityReplica -Name "SecondaryServer\Instance" -EndpointUrl "TCP://PrimaryServerName.domain.com:5022" -FailoverMode Manual -AvailabilityMode AsynchronousCommit -ConnectionModeInSecondaryRole AllowAllConnections -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG"
Perintah ini menambahkan replika ketersediaan ke grup ketersediaan yang ada bernama MainAG. Replika ini mendukung failover manual dan mode ketersediaan penerapan asinkron. Dalam peran sekunder, replika ini mendukung koneksi akses baca. Konfigurasi ini memungkinkan Anda membongkar pemrosesan baca-saja ke replika ini.
Parameter
-AsTemplate
Menunjukkan bahwa cmdlet ini membuat objek AvailabilityReplica sementara dalam memori. Tentukan parameter ini untuk membuat grup ketersediaan sebelum Anda membuat replika ketersediaan. Buat grup ketersediaan dengan menggunakan cmdlet New-SqlAvailabilityGroup. Tentukan replika ketersediaan sementara sebagai nilai parameter AvailabilityReplica .
Jika Anda menentukan AsTemplate, cmdlet ini mengabaikan nilai untuk parameter InputObject dan Path .
Jika Anda menentukan parameter ini, Anda juga harus menentukan versi SQL Server untuk parameter Versi , atau sesi Anda saat ini harus memiliki koneksi aktif ke instans.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
AsTemplate
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-AvailabilityMode
Menentukan mode ketersediaan replika. Nilai yang dapat diterima untuk parameter ini adalah:
- SynchronousCommit
- AsinkronCommit
Anda dapat menentukan nilai $Null.
Properti parameter
| Jenis: | AvailabilityReplicaAvailabilityMode |
| 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 |
-BackupPriority
Menentukan prioritas replika yang diinginkan dalam melakukan pencadangan. Nilai yang dapat diterima untuk parameter ini adalah: bilangan bulat dari 0 hingga 100. Dari set replika yang online dan tersedia, replika yang memiliki prioritas tertinggi melakukan pencadangan.
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 |
-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 |
-ConnectionModeInPrimaryRole
Menentukan bagaimana replika ketersediaan menangani koneksi saat berada dalam peran utama. Nilai yang dapat diterima untuk parameter ini adalah:
- AllowReadWriteConnections. Perbolehkan koneksi baca/tulis
- AllowAllConnections. Perbolehkan semua koneksi
Properti parameter
| Jenis: | AvailabilityReplicaConnectionModeInPrimaryRole |
| 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 |
-ConnectionModeInSecondaryRole
Menentukan bagaimana replika ketersediaan menangani koneksi saat berada dalam peran sekunder. Nilai yang dapat diterima untuk parameter ini adalah:
- AllowNoConnections. Melarang koneksi
- AllowReadIntentConnectionsOnly. Hanya memperbolehkan koneksi baca-niat
- AllowAllConnections. Perbolehkan semua koneksi
Properti parameter
| Jenis: | AvailabilityReplicaConnectionModeInSecondaryRole |
| 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 |
-EndpointUrl
Menentukan URL titik akhir pencerminan database. URL ini adalah alamat TCP dalam formulir berikut:
TCP://system-address:port
Properti parameter
| Jenis: | String |
| 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 |
-FailoverMode
Menentukan mode failover. Nilai yang dapat diterima untuk parameter ini adalah:
- Otomatis
- Manual Anda dapat menentukan nilai $Null.
Properti parameter
| Jenis: | AvailabilityReplicaFailoverMode |
| 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 |
-InputObject
Menentukan grup ketersediaan, sebagai objek AvailabilityGroup , tempat replika berada.
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 replika ketersediaan dalam format berikut:
Komputer\Instans
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 replika berada. 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 |
-ReadonlyRoutingConnectionUrl
Menentukan nama domain yang sepenuhnya memenuhi syarat (FQDN) dan port yang akan digunakan saat perutean ke replika untuk koneksi baca saja, seperti dalam contoh berikut:
TCP://DBSERVER8.manufacturing.Contoso.com:7024
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 |
-ReadOnlyRoutingList
Menentukan daftar nama server replika yang diurutkan yang mewakili urutan pemeriksaan untuk digunakan oleh direktur koneksi saat mengalihkan koneksi baca-saja melalui replika ketersediaan ini. Parameter ini berlaku jika replika ketersediaan adalah replika utama grup ketersediaan saat 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 |
-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 |
-SessionTimeout
Menentukan jumlah waktu, dalam detik, untuk menunggu respons antara replika utama dan replika ini sebelum koneksi gagal.
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 |
-Version
Menentukan versi SQL Server. Jika Anda menentukan parameter AsTemplate , Anda harus menentukan versi. Objek templat dibuat dalam mode desain di server yang menyertakan versi ini. Anda dapat menentukan bilangan bulat atau string, seperti dalam contoh berikut:
- 13
- "13.0.0"
Properti parameter
| Jenis: | ServerVersion |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
AsTemplate
| 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.AvailabilityGroup
Anda dapat meneruskan grup ketersediaan ke cmdlet ini.
Output
Microsoft.SqlServer.Management.Smo.AvailabilityReplica
Cmdlet ini mengembalikan replika ketersediaan.