Resolve-ServiceFabricService

ステートフル Service Fabric のパーティション分割されたサービスのレプリカ アドレスまたはステートレス Service Fabric サービスのインスタンスのアドレスを取得します。

構文

Resolve-ServiceFabricService
       [-PartitionKindSingleton]
       [-ServiceName] <Uri>
       [-PreviousResult <ResolvedServicePartition>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Resolve-ServiceFabricService
       [-PartitionKindSingleton]
       [-ServiceName] <Uri>
       [-ForceRefresh]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Resolve-ServiceFabricService
       [-PartitionKindUniformInt64]
       [-ServiceName] <Uri>
       [-PartitionKey] <String>
       [-ForceRefresh]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Resolve-ServiceFabricService
       [-PartitionKindUniformInt64]
       [-ServiceName] <Uri>
       [-PartitionKey] <String>
       [-PreviousResult <ResolvedServicePartition>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Resolve-ServiceFabricService
       [-PartitionKindNamed]
       [-ServiceName] <Uri>
       [-PartitionKey] <String>
       [-ForceRefresh]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Resolve-ServiceFabricService
       [-PartitionKindNamed]
       [-ServiceName] <Uri>
       [-PartitionKey] <String>
       [-PreviousResult <ResolvedServicePartition>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

説明

Resolve-ServiceFabricService コマンドレットは、ステートフル Service Fabric のパーティション分割されたサービスのレプリカ アドレスまたはステートレス Service Fabric サービスのインスタンスのアドレスを取得します。

アドレスはローカル ノードにキャッシュされ、アドレスへの接続が失敗した場合に更新できます。 通常、接続の失敗は、レプリカまたはインスタンスが別のノードに移動したことを示します。

Service Fabric クラスターで操作を実行する前に、 Connect-ServiceFabricCluster コマンドレットを使用してクラスターへの接続を確立します。

例 1: アドレスを解決する

PS C:\> Resolve-ServiceFabricService -PartitionKindUniformInt64 -ServiceName fabric:/myApp/myService -PartitionKey "0"

このコマンドは、fabric:/myApp/myService という名前のサービスのパーティション キー 0 によってマップされた均一な Int64 パーティションのアドレスを取得します。

例 2: 前の結果を使用してローカル キャッシュを更新する

PS C:\> $result = Resolve-ServiceFabricService -ServiceName fabric:/TestApplication/TestService/1 -PartitionKindSingleton
PS C:\> Resolve-ServiceFabricService -ServiceName fabric:/TestApplication/TestService/1 -PartitionKindSingleton -PreviousResult $result

このコマンドは、最初の解決呼び出しの結果を後続の解決呼び出しに提供します。 これは、最初の呼び出しで以前に取得した結果が古くなっていることをユーザーが認識している場合に必要です。 接続要求がタイムアウトするか、エラーが返された場合、エンドポイントは古いと見なされます。

例 3: ローカル キャッシュを強制的に更新する

PS C:\> Resolve-ServiceFabricService -ServiceName fabric:/TestApplication/TestService/1 -PartitionKindSingleton -ForceRefresh

このコマンドは、ローカル エンドポイント キャッシュを強制的に更新した後、シングルトン パーティション内のステートフル レプリカのアドレスを取得します。

パラメーター

-ForceRefresh

コマンドレットによって解決されたアドレスのローカル キャッシュが強制的に更新されることを示します。

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

-PartitionKey

Service Fabric サービスのパーティション キーを指定します。

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

-PartitionKindNamed

Service Fabric サービスが名前付きパーティションであることを示します。

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

-PartitionKindSingleton

Service Fabric サービスがシングルトン パーティションであることを示します。

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

-PartitionKindUniformInt64

Service Fabric サービスが UniformInt64 パーティションであることを示します。

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

-PreviousResult

前の解決サービス パーティションの結果を指定します。 これは、以前に取得された結果が古くなっていることをユーザーが認識している場合に必要です。

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

-ServiceName

Service Fabric サービスの URI を指定します。

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

-TimeoutSec

操作のタイムアウト期間を秒単位で指定します。

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

入力

System.Uri

System.String

System.Fabric.ResolvedServicePartition

System.Management.Automation.SwitchParameter

出力

System.Object