Update-ServiceFabricService

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.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Accepted values:	Zero, Low, Medium, High, VeryHigh
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DropSourceReplicaOnMove

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Memaksa perintah untuk berjalan tanpa meminta konfirmasi pengguna.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InstanceCount

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

Type:	InstanceLifecycleDescription
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionNamesToAdd

{{Fill PartitionNamesToAdd Description}}

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionNamesToRemove

{{Fill PartitionNamesToRemove Description}}

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PlacementConstraints

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PlacementPolicy

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

Type:	ReplicaLifecycleDescription
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ScalingPolicies

{{Fill ScalingPolicies Description}}

Type:	System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServiceDnsName

Menentukan nama DNS layanan yang diperbarui.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServiceName

Menentukan URI layanan Service Fabric yang propertinya perlu diperbarui.

Type:	Uri
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ServicePlacementTimeLimit

Mengatur batas waktu penempatan layanan.

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StandByReplicaKeepDuration

Menentukan durasi penyimpanan replika siaga yang diperbarui sebagai objek TimeSpan .

Untuk mempelajari selengkapnya tentang QuorumLossWaitDuration, lihat StatefulServiceDescription.StandByReplicaKeepDuration.

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Stateful

Menunjukkan bahwa layanan ini adalah layanan stateful Service Fabric.

Type:	SwitchParameter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Stateless

Menunjukkan bahwa layanan ini adalah layanan stateless Service Fabric.

Type:	SwitchParameter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TargetReplicaSetSize

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

Jangan tentukan parameter ini untuk layanan stateless.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeoutSec

Menentukan periode waktu habis, dalam detik, untuk operasi.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Input

System.Uri

Output

System.Object

Link Terkait

• Connect-ServiceFabricCluster
• Get-ServiceFabricClusterConnection
• Get-ServiceFabricService
• New-ServiceFabricService
• Remove-ServiceFabricService
• Resolve-ServiceFabricService