你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Get-ServiceFabricApplication

模块:

ServiceFabric

获取 Service Fabric 群集上的应用程序 () 。

语法

Get-ServiceFabricApplication
   [[-ApplicationName] <Uri>]
   [-ApplicationTypeName <String>]
   [-ExcludeApplicationParameters]
   [-ContinuationToken <String>]
   [-ApplicationDefinitionKindFilter <ApplicationDefinitionKindFilter>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Get-ServiceFabricApplication
   [[-ApplicationName] <Uri>]
   [-ApplicationTypeName <String>]
   [-ExcludeApplicationParameters]
   [-GetSinglePage]
   [-ContinuationToken <String>]
   [-MaxResults <Int64>]
   [-ApplicationDefinitionKindFilter <ApplicationDefinitionKindFilter>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

说明

Get-ServiceFabricApplication cmdlet 获取 Service Fabric 群集上的应用程序 () 。 默认情况下，对于此查询可以返回的查询结果数没有限制，而不考虑最大消息大小配置：虽然这是分页查询，与 REST 或 C# 等效调用不同，但此查询的默认行为是透明地循环访问所有返回的页面。 GetSinglePage 选项配置此查询以返回单个页面。

在 Service Fabric 群集上执行任何操作之前，请使用 Connect-ServiceFabricCluster cmdlet 建立与群集的连接。

示例

示例 1：获取所有应用程序

PS C:\> Get-ServiceFabricApplication

ApplicationName           : fabric:/samples/CalculatorApp
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

ApplicationName           : fabric:/samples/CalculatorAppWithAppParameters
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 2.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : { "ServiceInstanceCount" = "4" }

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

ApplicationName           : fabric:/VQueueApp1
ApplicationTypeName       : Compose_0
ApplicationTypeVersion    : v0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : Compose
ApplicationParameters     : {}

此命令获取群集中的所有应用程序。

示例 2：按名称获取应用程序

PS C:\> Get-ServiceFabricApplication -ApplicationName fabric:/samples/PQueueApp1

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

此命令获取名称为 fabric：/samples/PQueueApp1 的特定应用程序。

示例 3：按类型名称获取应用程序

PS C:\>Get-ServiceFabricApplication -ApplicationTypeName PersistentQueueApp

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

此命令获取 Service Fabric 应用程序 (其类型名称为 PersistentQueueApp 的) 。

示例 4：按定义类型获取应用程序

PS C:\>Get-ServiceFabricApplication -ApplicationDefinitionKindFilter Compose

ApplicationName           : fabric:/VQueueApp1
ApplicationTypeName       : Compose_0
ApplicationTypeVersion    : v0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : Compose
ApplicationParameters     : {}

此命令获取 Service Fabric 应用程序 () ，这些) 由 Service Fabric 应用程序说明定义。

示例 5：获取具有最大结果的应用程序

PS C:\>Get-ServiceFabricApplication -MaxResults 2 -GetSinglePage -Verbose

ApplicationName           : fabric:/samples/CalculatorApp
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

ApplicationName           : fabric:/samples/CalculatorAppWithAppParameters
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 2.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : "ServiceInstanceCount" = "4"
                            

VERBOSE: Continuation Token: fabric:/samples/CalculatorAppWithAppParameters

此命令获取群集中适合页面的所有 Service Fabric 应用程序 () 。 虽然群集中有更多应用程序，但 MaxResults 参数仅返回两个结果。 由于存在不适合页面的结果，因此返回延续标记值，指示存在后续页面。

示例 6：使用延续标记获取应用程序

PS C:\>Get-ServiceFabricApplication -ContinuationToken fabric:/samples/CalculatorAppWithAppParameters -GetSinglePage -Verbose

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

ApplicationName           : fabric:/VQueueApp1
ApplicationTypeName       : Compose_0
ApplicationTypeVersion    : v0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : Compose
ApplicationParameters     : {}

VERBOSE: Continuation Token:

此命令获取 Service Fabric 应用程序 (s) ，该标记遵循提供给单页的延续标记。 提供给此查询的延续标记与上例返回的延续标记相同。 “详细”选项不显示任何延续标记，表示没有更多页面可用。

示例 7：排除应用程序参数时按名称获取应用程序

PS C:\>Get-ServiceFabricApplication -ApplicationName fabric:/samples/CalculatorAppWithAppParameters -ExcludeApplicationParameters

ApplicationName           : fabric:/samples/CalculatorAppWithAppParameters
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 2.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

此命令获取与所提供的应用程序名称匹配的 Service Fabric 应用程序。 如示例 5 所示，此应用程序具有应用程序参数，但由于“ExcludeApplicationParameters”标志，从返回的结果 () 中排除

参数

-ApplicationDefinitionKindFilter

根据应用程序的定义方式指定 ApplicationDefinitionKindFilter 的筛选器。 可以从 ApplicationDefinitionKindFilter 成员的成员或按位操作获取该值。 仅返回与筛选器匹配的应用程序。 最多可以指定 ApplicationName、ApplicationTypeName 或 ApplicationDefinitionKindFilter 之一。 如果未指定筛选器，则返回所有应用程序。

Type:	ApplicationDefinitionKindFilter
Accepted values:	Default, ServiceFabricApplicationDescription, Compose, MeshApplicationDescription, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationName

指定 Service Fabric 应用程序的统一资源标识符 (URI) 。 该 cmdlet 获取具有指定 URI 的应用程序。 最多可以指定 ApplicationName、ApplicationTypeName 或 ApplicationDefinitionKindFilter 之一。 如果未指定筛选器，则返回所有应用程序。

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

-ApplicationTypeName

指定用于筛选要查询的应用程序的应用程序类型名称。 最多可以指定 ApplicationName、ApplicationTypeName 或 ApplicationDefinitionKindFilter 之一。 如果未指定筛选器，则返回所有应用程序。

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

-ContinuationToken

指定可用于检索下一页查询结果的延续标记。

如果结果过多，则它们可能无法容纳到一条消息中。 分页通过将返回的结果集合拆分为单独的页面来考虑这一点。 延续标记用于知道上一页离开的位置，只对查询本身具有意义。 此值应从运行此查询生成，并可以传递到下一个查询请求中，以便获取后续页面。 仅当有后续页面时，才会返回非 null 继续标记值作为结果的一部分。 如果没有 -GetSinglePage 选项，则查询将返回从继续标记值开始的所有页面。

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

-ExcludeApplicationParameters

指定是否将应用程序参数从结果中排除。

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

-GetSinglePage

指定查询是使用延续标记值返回一页查询结果，还是将所有页面组合成一个结果列表。 如果选择此选项，则查询调用方负责检查后续页面。

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

-MaxResults

指定每页可返回的最大结果项数。 这定义了返回的结果数的上限，而不是最小值。 例如，如果页面最多适合 1000 个返回的项目，根据配置中定义的最大消息大小限制，并且 MaxResults 值设置为 2000，则即使 2000 个结果项与查询说明匹配，也只返回 1000 个结果。 此值需要选择 GetSinglePage 标志;否则将被忽略。

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

相关链接

• Connect-ServiceFabricCluster
• Get-ServiceFabricClusterConnection
• New-ServiceFabricApplication
• Remove-ServiceFabricApplication