Update-ServiceFabricService

Referensi

Modul:: ServiceFabric

Updates layanan Service Fabric.

Sintaks

Update-ServiceFabricService
      [-Stateless]
      [-ServiceName] <Uri>
      [-InstanceCount <Int32>]
      [-MinInstanceCount <Int32>]
      [-MinInstancePercentage <Int32>]
      [-InstanceLifecycleDescription <InstanceLifecycleDescription>]
      [-Force]
      [-PlacementConstraints <String>]
      [-Metric <String[]>]
      [-Correlation <String[]>]
      [-PlacementPolicy <String[]>]
      [-DefaultMoveCost <String>]
      [-PartitionNamesToAdd <String[]>]
      [-PartitionNamesToRemove <String[]>]
      [-ScalingPolicies <System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]>]
      [-InstanceCloseDelayDuration <TimeSpan>]
      [-InstanceRestartWaitDuration <TimeSpan>]
      [-ServiceDnsName <String>]
      [-TagsRequiredToPlace <System.Collections.Generic.List`1[System.String]>]
      [-TagsRequiredToRun <System.Collections.Generic.List`1[System.String]>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-ServiceFabricService
      [-Stateful]
      [-ServiceName] <Uri>
      [-TargetReplicaSetSize <Int32>]
      [-MinReplicaSetSize <Int32>]
      [-ReplicaRestartWaitDuration <TimeSpan>]
      [-QuorumLossWaitDuration <TimeSpan>]
      [-StandByReplicaKeepDuration <TimeSpan>]
      [-ServicePlacementTimeLimit <TimeSpan>]
      [-DropSourceReplicaOnMove <Boolean>]
      [-ReplicaLifecycleDescription <ReplicaLifecycleDescription>]
      [-Force]
      [-PlacementConstraints <String>]
      [-Metric <String[]>]
      [-Correlation <String[]>]
      [-PlacementPolicy <String[]>]
      [-DefaultMoveCost <String>]
      [-PartitionNamesToAdd <String[]>]
      [-PartitionNamesToRemove <String[]>]
      [-ScalingPolicies <System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]>]
      [-ServiceDnsName <String>]
      [-TagsRequiredToPlace <System.Collections.Generic.List`1[System.String]>]
      [-TagsRequiredToRun <System.Collections.Generic.List`1[System.String]>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Deskripsi

Cmdlet Update-ServiceFabricService memperbarui properti dari layanan Service Fabric yang sedang berjalan. Kumpulan properti yang dapat diperbarui adalah subset properti yang ditentukan pada saat membuat layanan (menggunakan New-ServiceFabricService atau New-ServiceFabricServiceFromTemplate). Anda bisa mendapatkan properti layanan Anda saat ini menggunakan Get-ServiceFabricServiceDescription.

Harap dicatat bahwa memperbarui properti layanan yang sedang berjalan berbeda dengan meningkatkan layanan Anda menggunakan Start-ServiceFabricApplicationUpgrade. Meningkatkan layanan Anda (yaitu aplikasi) adalah tugas latar belakang yang berjalan lama yang melibatkan pemindahan aplikasi Anda, dari satu versi ke versi lainnya, satu domain peningkatan pada satu waktu. Silakan lihat Peningkatan Aplikasi Service Fabric untuk detail selengkapnya.

Sebelum Anda melakukan operasi apa pun pada kluster Service Fabric, buat koneksi ke kluster dengan menggunakan cmdlet Connect-ServiceFabricCluster .

Contoh

Contoh 1: Memperbarui layanan stateful

PS C:\> Update-ServiceFabricService -Stateful fabric:/myapp/test -MinReplicaSetSize 3 -TargetReplicaSetSize 5

Perintah ini memperbarui MinReplicaSetSize dan TargetReplicaSetSize dari Fabric Service yang sedang berjalan menjadi tiga (3) dan lima (5).

Contoh 2: Memperbarui layanan stateless

PS C:\> Update-ServiceFabricService -Stateless fabric:/myapp/test -InstanceCount -1

Perintah ini memperbarui jumlah instans Fabric Service yang sedang berjalan ke nilai -1.

Contoh 3: Memperbarui batasan penempatan

PS C:\> Update-ServiceabricService -Stateless -ServiceName fabric:/myapp/test -PlacementConstraints "NodeName!=NodeBar"

Perintah ini memperbarui batasan penempatan.

Contoh 4: Memperbarui metrik beban default

PS C:\> Update-ServiceFabricService -Stateless -ServiceName fabric:/myapp/test -Metric @("CPU,High,10")
PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -Metric @("CPU,High,10,1")

Perintah pertama memperbarui metrik beban default untuk layanan stateless.

Perintah kedua memperbarui metrik beban default untuk layanan stateful.

Contoh 5: Memperbarui kebijakan penempatan

PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -PlacementPolicy @("InvalidDomain,fd:/dc2/rack2")

Perintah ini memperbarui kebijakan penempatan.

Contoh 6: Memperbarui korelasi layanan

PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -Correlation @("fabric:/app/test2,AlignedAffinity")

Perintah ini memperbarui korelasi layanan.

Contoh 7: Memperbarui nama DNS layanan

PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -ServiceDnsName stateful.dns
PS C:\> Update-ServiceFabricService -Stateless -ServiceName fabric:/myapp/test -ServiceDnsName stateless.dns

Perintah ini memperbarui nama DNS layanan layanan. Catatan : Jika nama DNS yang diperbarui telah dikueri pada kluster atau layanan pembaruan sudah memiliki nama DNS, layanan DNS harus dimulai ulang setelah pembaruan untuk membatalkan cache.

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:	SwitchParameter
Alias:	cf
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Correlation

Menentukan array batasan korelasi yang diperbarui untuk layanan ini. Untuk mempelajari selengkapnya tentang korelasi layanan, lihat Mengonfigurasi dan menggunakan afinitas layanan di Service Fabric.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-DefaultMoveCost

Menentukan biaya pemindahan default yang diperbarui yang dimiliki replika saat dibuat. Nilai yang dapat diterima untuk parameter ini adalah:

Nol
Rendah
Medium
Tinggi

Untuk detail selengkapnya tentang biaya pemindahan, lihat Biaya pemindahan layanan untuk memengaruhi pilihan Resource Manager Kluster.

Jenis:	String
Nilai yang diterima:	Zero, Low, Medium, High, VeryHigh
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-DropSourceReplicaOnMove

Memungkinkan replika Sekunder sumber dihilangkan sebelum replika Sekunder baru menyelesaikan build.

Jenis:	Boolean
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Force

Memaksa perintah untuk berjalan tanpa meminta konfirmasi pengguna.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-InstanceCloseDelayDuration

Menentukan durasi dalam hitungan detik, untuk menunggu sebelum instans stateless yang terpengaruh oleh peningkatan aplikasi ditutup, untuk memungkinkan permintaan aktif menguras dengan baik. Durasi tunggu ini hanya efektif untuk instans layanan stateless yang memiliki nilai bukan nol yang dikonfigurasi untuk InstanceCloseDelayDuration, dan akan mengambil alih nilai yang telah dikonfigurasi sebelumnya. Lihat InstanceCloseDelayDuration untuk detailnya. Jangan tentukan parameter ini untuk layanan stateful.

Jenis:	TimeSpan
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-InstanceCount

Menentukan jumlah instans yang diperbarui untuk layanan stateless Service Fabric. Jangan tentukan parameter ini untuk layanan stateful.

Jenis:	Int32
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-InstanceLifecycleDescription

Deskripsi siklus hidup instans milik layanan ini. Jika beberapa konfigurasi di bagian ini tidak ditentukan, nilai default diambil dari parameter kluster dengan nama yang sama (jika ada).

Jenis:	InstanceLifecycleDescription
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-InstanceRestartWaitDuration

Ketika instans stateless turun, timer ini dimulai. Ketika kedaluwarsa Service Fabric akan membuat instans baru pada node apa pun di kluster. Konfigurasi ini untuk mengurangi pembuatan instans baru yang tidak perlu dalam situasi saat instans tidak berfungsi kemungkinan akan pulih dalam waktu singkat. Misalnya, selama peningkatan. Nilai defaultnya adalah 0, yang menunjukkan bahwa ketika instans stateless turun, Service Fabric akan segera mulai membangun penggantinya.

Jenis:	TimeSpan
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Metric

Menentukan array metrik yang diperbarui yang dilaporkan layanan. Untuk mempelajari selengkapnya tentang metrik, lihat Mengelola konsumsi dan beban sumber daya di Service Fabric dengan metrik.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-MinInstanceCount

Menentukan jumlah minimum instans partisi layanan stateless yang diperbarui. Lihat MinInstanceCount (dalam New-ServiceFabricService) untuk detailnya. Jangan tentukan parameter ini untuk layanan stateful.

Jenis:	Int32
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-MinInstancePercentage

Menentukan persentase minimum InstanceCount yang diperbarui dari partisi layanan stateless. Lihat MinInstancePercentage (dalam New-ServiceFabricService) untuk detailnya. Jangan tentukan parameter ini untuk layanan stateful.

Jenis:	Int32
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-MinReplicaSetSize

Menentukan ukuran set replika minimum yang diperbarui untuk layanan stateful Service Fabric. Nilai harus kurang dari TargetReplicaSetSize dari layanan ini. Untuk detail selengkapnya, lihat StatefulServiceDescription.MinReplicaSetSize.

Jangan tentukan parameter ini untuk layanan stateless.

Jenis:	Int32
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-PartitionNamesToAdd

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-PartitionNamesToRemove

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-PlacementConstraints

Menentukan batasan penempatan yang diperbarui untuk layanan. Untuk mempelajari selengkapnya tentang batasan penempatan, lihat Batasan penempatan dan properti simpul.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-PlacementPolicy

Menentukan array kebijakan penempatan yang diperbarui untuk layanan. Untuk mempelajari selengkapnya tentang PlacementPolicy, lihat Kebijakan penempatan untuk layanan service fabric.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-QuorumLossWaitDuration

Menentukan durasi yang diperbarui, sebagai objek TimeSpan , bahwa Service Fabric menunggu sebelum menyatakan kehilangan data untuk partisi layanan.

Untuk mendapatkan objek TimeSpan , gunakan cmdlet New-TimeSpan . Untuk informasi selengkapnya, ketik Get-Help New-TimeSpan.

Untuk mempelajari selengkapnya tentang parameter QuorumLossWaitDuration, lihat StatefulServiceDescription.QuorumLossWaitDuration.

Jenis:	TimeSpan
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ReplicaLifecycleDescription

Deskripsi siklus hidup replika milik layanan ini. Jika beberapa konfigurasi di bagian ini tidak ditentukan, nilai default diambil dari parameter kluster dengan nama yang sama (jika ada).

Jenis:	ReplicaLifecycleDescription
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ReplicaRestartWaitDuration

Menentukan interval yang diperbarui, sebagai objek TimeSpan , service Fabric menunggu replika dimulai ulang sebelum membuat replika pengganti. Untuk mendapatkan objek TimeSpan , gunakan cmdlet New-TimeSpan .

Untuk mempelajari selengkapnya tentang QuorumLossWaitDuration, lihat StatefulServiceDescription.ReplicaRestartWaitDuration.

Jenis:	TimeSpan
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ScalingPolicies

Jenis:	System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ServiceDnsName

Menentukan nama DNS layanan yang diperbarui.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ServiceName

Menentukan URI layanan Service Fabric yang propertinya perlu diperbarui.

Jenis:	Uri
Position:	1
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	False

-ServicePlacementTimeLimit

Mengatur batas waktu penempatan layanan.

Jenis:	TimeSpan
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-StandByReplicaKeepDuration

Menentukan durasi penyimpanan replika siaga yang diperbarui sebagai objek TimeSpan .

Untuk mempelajari selengkapnya tentang QuorumLossWaitDuration, lihat StatefulServiceDescription.StandByReplicaKeepDuration.

Jenis:	TimeSpan
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Stateful

Menunjukkan bahwa layanan ini adalah layanan stateful Service Fabric.

Jenis:	SwitchParameter
Position:	0
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-Stateless

Menunjukkan bahwa layanan ini adalah layanan stateless Service Fabric.

Jenis:	SwitchParameter
Position:	0
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-TagsRequiredToPlace

Mendeklarasikan tag yang diperlukan untuk penempatan layanan. Berguna untuk mempengaruhi penempatan layanan secara dinamis. Untuk informasi selengkapnya, lihat Tag Node Dinamis Service Fabric.

Jenis:	System.Collections.Generic.List`1[System.String]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-TagsRequiredToRun

Mendeklarasikan tag yang diperlukan untuk penempatan dan menjalankan layanan. Berguna untuk mempengaruhi penempatan layanan secara dinamis dan berjalan. Untuk informasi selengkapnya, lihat Tag Node Dinamis Service Fabric

Jenis:	System.Collections.Generic.List`1[System.String]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-TargetReplicaSetSize

Menentukan ukuran set replika target yang diperbarui untuk layanan stateful Service Fabric. Untuk detail selengkapnya, lihat StatefulServiceDescription.TargetReplicaSetSize.