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

Get-ServiceFabricDeployedApplication

模块:

ServiceFabric

获取指定节点上的 Service Fabric 应用程序 () 。

语法

Get-ServiceFabricDeployedApplication
   [-NodeName] <String>
   [[-ApplicationName] <Uri>]
   [-UsePaging]
   [-GetSinglePage]
   [-IncludeHealthState]
   [-MaxResults <Int64>]
   [-ContinuationToken <String>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Get-ServiceFabricDeployedApplication
   [-NodeName] <String>
   [[-ApplicationName] <Uri>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

说明

Get-ServiceFabricDeployedApplication cmdlet 获取在指定节点上部署的 Service Fabric 应用程序 (s) 。

Service Fabric 为每个已部署的应用程序在节点上创建工作、日志和临时目录。 由于目录名称包括应用程序 ID，因此无法猜测目录名称。 当 DeployedApplicationStatus 处于活动状态时，Get-ServiceFabricDeployedApplication 返回 WorkDirectory、LogDirectory 和 TempDirectory 返回值中的目录名称。 当 DeployedApplicationStatus 正在下载时，WorkDirectory、LogDirectory 和 TempDirectory 值为 null。

部署的应用程序服务将其持久化数据存储在 WorkDirectory 中。 出于调试或诊断目的，其他应用程序或进程可能需要知道 WorkDirectory 的位置。

部署的应用程序服务应将其日志存储在 Service Fabric 创建的 LogDirectory 中。 日志文件的自定义上传程序可能需要知道位置。 当特定节点上的应用程序未按预期工作时，可能需要 LogDirectory 的位置才能进行诊断。

默认情况下，此查询返回限制为最大消息大小配置的结果数。 SDK 和群集版本 6.1 或更高版本支持分页功能，可消除此限制;新行为是返回结果，而不考虑最大消息大小配置，因为此查询以透明方式循环访问所有返回的页面。 若要使用分页和其他新功能，请参阅参数集“UsePagedAPI”。 选择任何新筛选器会向查询发出信号，以在后台使用分页。 否则，请选择“UsePaging”以选择分页查询。

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

示例

示例 1：获取应用程序“fabric：/samples/CalcApp2”

PS C:\> Get-ServiceFabricDeployedApplication -NodeName "VIPULM4-RK01-BD01" -ApplicationName fabric:/samples/CalcApp2

ApplicationName           : fabric:/samples/CalcApp2
ApplicationTypeName       : CalculatorApp
DeployedApplicationStatus : Active
WorkDirectory             : D:\ServiceFabric\Data\VIPULM4-RK01-BD01\Fabric\work\Applications\CalculatorApp_App5\work
LogDirectory              : D:\ServiceFabric\Data\VIPULM4-RK01-BD01\Fabric\work\Applications\CalculatorApp_App5\log
TempDirectory             : D:\ServiceFabric\Data\VIPULM4-RK01-BD01\Fabric\work\Applications\CalculatorApp_App5\temp
HealthState               : Unknown

此命令返回已部署的应用程序。 在此示例中， DeployedApplicationStatus 为 Active，因此 Get-ServiceFabricDeployedApplication 返回 WorkDirectory、 LogDirectory 和 TempDirectory 返回值中的目录名称。

示例 2：获取应用程序“fabric：/samples/VQueueApp2”

PS C:\> Get-ServiceFabricDeployedApplication -NodeName VIPULM4-RK01-BD01 fabric:/samples/VQueueApp2

ApplicationName           : fabric:/samples/VQueueApp2
ApplicationTypeName       : VolatileQueueApp
DeployedApplicationStatus : Downloading
HealthState               : Unknown

此命令返回已部署的应用程序。 在此示例中，DeployedApplicationStatus 正在下载，因此，该命令返回 WorkDirectory、LogDirectory 和 TempDirectory 的 null 值。

示例 3：使用最大结果获取应用程序 ()

PS C:\>Get-ServiceFabricDeployedApplication -NodeName _Node_1 -MaxResults 2 -GetSinglePage -Verbose

ApplicationName           : fabric:/samples/CalculatorApp
ApplicationTypeName       : CalculatorApp
DeployedApplicationStatus : Active
WorkDirectory             : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\work
LogDirectory              : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\log
TempDirectory             : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\temp
HealthState               : Unknown

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
DeployedApplicationStatus : Active
WorkDirectory             : C:\SfDevCluster\Data\_App\_Node_1\PersistentQueueApp_App1\work
LogDirectory              : C:\SfDevCluster\Data\_App\_Node_1\PersistentQueueApp_App1\log
TempDirectory             : C:\SfDevCluster\Data\_App\_Node_1\PersistentQueueApp_App1\temp
HealthState               : Unknown

VERBOSE: Continuation Token: fabric:/samples/PQueueApp1

此命令获取群集中提供的节点上部署的所有 Service Fabric 应用程序 () ，这些节点适合页面。 页面的大小进一步限制为两个项目，由 MaxResults 参数配置。 由于我们选择了“GetSinglePage”选项，因此此查询仅返回一页结果。 如果没有此选项，则无法使用 MaxResults。 选择“详细”会打印返回的继续标记值。 此值可用于后续查询以获取下一页的结果。 还可以通过保存返回的结果和访问“ContinuationToken”属性来访问返回的延续令牌。 “ContinuationToken”属性为 null，则没有返回的延续标记。

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

PS C:\>Get-ServiceFabricDeployedApplication -NodeName _Node_1 -ContinuationToken fabric:/samples/PQueueApp1 -UsePaging

ApplicationName           : fabric:/samples/VQueueApp1
ApplicationTypeName       : VolatileQueueApp
DeployedApplicationStatus : Active
WorkDirectory             : C:\SfDevCluster\Data\_App\_Node_1\VolatileQueueApp_App2\work
LogDirectory              : C:\SfDevCluster\Data\_App\_Node_1\VolatileQueueApp_App2\log
TempDirectory             : C:\SfDevCluster\Data\_App\_Node_1\VolatileQueueApp_App2\temp
HealthState               : Unknown

此命令获取 Service Fabric 应用程序 (s) ，该标记遵循提供给单页的延续标记。 提供给此查询的延续标记与上例返回的延续标记相同。 在此示例群集中，只有一个项尊重延续标记。 如果节点上的继续标记过多，无法容纳到结果的一页中，则此查询配置将返回所有返回页的编译，以透明方式循环访问它们：然后，查询将返回所有结果的向量。 若要仅获取一页的结果，请选择“GetSinglePage”选项。

示例 5：获取处于运行状况的应用程序

PS C:\>Get-ServiceFabricDeployedApplication -NodeName _Node_1 -ApplicationName fabric:/samples/CalculatorApp -IncludeHealthState

ApplicationName           : fabric:/samples/CalculatorApp
ApplicationTypeName       : CalculatorApp
DeployedApplicationStatus : Active
WorkDirectory             : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\work
LogDirectory              : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\log
TempDirectory             : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\temp
HealthState               : Ok

此命令获取与所提供的应用程序名称匹配的 Service Fabric 应用程序，并包括其运行状况。

参数

-ApplicationName

指定 Service Fabric 应用程序的统一资源标识符 (URI) 。 该 cmdlet 获取与指定应用程序名称匹配的已部署应用程序。 此查询与完全匹配。 例如，URI 构造：/App 与 fabric：/App1 不匹配。 如果提供应用程序名称，最多会返回一个结果。 如果提供的应用程序名称与节点上的任何应用程序不匹配，查询将返回 null。

Type:	Uri
Position:	1
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

-GetSinglePage

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

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

-IncludeHealthState

指定查询是否返回已部署应用程序的运行状况状态。如果未指定此参数，则返回的运行状况状态为“未知”。 选中后，查询会与节点和运行状况系统服务并行进行，然后再合并结果。 因此，查询开销更高，并可能需要更长的时间。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
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

-NodeName

指定 Service Fabric 节点的名称。 该 cmdlet 获取在指定的节点上部署的应用程序。

Type:	String
Position:	0
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

-UsePaging

指定是否对查询进行分页。 如果未选中，则当结果过多而无法容纳到一个页面上时，此查询将不起作用，如最大消息大小配置所定义。 选择此选项可将此查询配置为返回所有结果，而不考虑最大消息大小配置。 它通过获取分页结果，并代表调用方以透明方式遍历所有页面来执行此操作。

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

输入

System.String

System.Uri

输出

System.Object

相关链接

• Connect-ServiceFabricCluster
• Get-ServiceFabricClusterConnection
• Get-ServiceFabricApplication