你当前正在访问 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 应用程序。

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。

类型:	Uri
Position:	1
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-ContinuationToken

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

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-GetSinglePage

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IncludeHealthState

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MaxResults

指定每个页面可返回的最大结果项数。 这定义了返回的结果数的上限，而不是最小值。 例如，如果页面根据配置中定义的最大消息大小限制最多容纳 1000 个返回的项目，并且 MaxResults 值设置为 2000，则即使 2000 个结果项与查询说明匹配，也只返回 1000 个结果。

此值需要选择 GetSinglePage 标志;否则将忽略它。

类型:	Int64
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NodeName

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

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-TimeoutSec

指定操作的超时期限（以秒为单位）。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UsePaging

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

System.String

System.Uri

输出

System.Object

相关链接

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