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

Get-ServiceFabricApplicationType

获取与提供的筛选器匹配的 Service Fabric 群集上注册的 Service Fabric 应用程序类型。

语法

Get-ServiceFabricApplicationType
   [[-ApplicationTypeName] <String>]
   [[-ApplicationTypeVersion] <String>]
   [-ApplicationTypeDefinitionKindFilter <ApplicationTypeDefinitionKindFilter>]
   [-ExcludeApplicationParameters]
   [-UsePaging]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
Get-ServiceFabricApplicationType
   [[-ApplicationTypeName] <String>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

说明

Get-ServiceFabricApplicationType cmdlet 获取在与提供的筛选器匹配的 Service Fabric 群集上注册或注册的 Service Fabric 应用程序类型。 应用程序类型的每个版本都作为结果数组中的单个结果返回。 如果未找到与提供的参数匹配的应用程序类型,则此查询不会返回任何内容。

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

示例

示例 1:获取所有已注册或注册应用程序类型

PS C:\> Get-ServiceFabricApplicationType

此命令获取所有已注册的应用程序类型。

示例 2:获取已注册或注册具有指定类型名称的应用程序类型

PS C:\> # Scenario: multiple application types are provisioned in the cluster, including TestApp versions 1 and 2, as well as TestApp2 version 1.
PS C:\> Get-ServiceFabricApplicationType -ApplicationTypeName "TestApp"

此命令获取应用程序类型“TestApp”的所有版本。 这不会获取应用程序类型“TestApp2”,因为应用程序类型名称不匹配。

示例 3:获取所有已注册或注册的应用程序类型,而不使用默认应用程序参数

PS C:\>Get-ServiceFabricApplicationType -ExcludeApplicationParameters

此命令获取所有已注册的应用程序类型。 返回的 System.Fabric.Query.ApplicationType 对象(s)具有未填充的 DefaultParameters 属性,无论应用程序类型是否具有默认应用程序参数。

示例 4:使用分页获取所有已注册或注册应用程序类型,然后进行管道

PS C:\> Get-ServiceFabricApplicationType -UsePaging | Get-ServiceFabricApplicationManifest

此命令使用分页获取所有已注册或注册应用程序类型。 这意味着,如果消息不适合一条消息,则不会删除消息,其大小由最大混乱大小配置决定。 分页由查询在后台完成。 管道和其他功能保持不变。

参数

-ApplicationTypeDefinitionKindFilter

根据应用程序类型的定义方式,为 ApplicationTypeDefinitionKindFilter 指定筛选器。 可以从 ApplicationTypeDefinitionKindFilter的成员的成员或按位操作获取该值。 仅返回与筛选器匹配的应用程序类型。 无法同时指定 ApplicationTypeName 和 ApplicationTypeDefinitionKindFilter。

类型:ApplicationTypeDefinitionKindFilter
接受的值:Default, ServiceFabricApplicationPackage, Compose, MeshApplicationDescription, All
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ApplicationTypeName

指定 Service Fabric 应用程序类型的名称。 该 cmdlet 获取指定的应用程序类型名称的所有版本。

如果未指定此参数,此 cmdlet 将获取所有应用程序类型。 此参数与所有预配或预配应用程序类型的应用程序清单中定义的区分大小写的确切应用程序类型名称匹配。 例如,值“Test”与“TestApp”不匹配,因为它只是部分匹配项。 此值不应包含应用程序类型的版本,并且与相同应用程序类型名称的所有版本匹配。

无法同时指定 ApplicationTypeName 和 ApplicationTypeDefinitionKindFilter。

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

-ApplicationTypeVersion

指定 Service Fabric 应用程序类型的版本。 该 cmdlet 获取与指定应用程序类型名称和版本匹配的应用程序类型。

仅当同时提供 ApplicationTypeName 参数时提供此参数。 此参数在 ApplicationTypeName 筛选器的顶部执行筛选器。 它与预配或预配应用程序类型的应用程序清单中定义的区分大小写的确切应用程序类型版本匹配。 例如,值“Version”与“Version1”不匹配,因为它只是部分匹配项。 此值不应包含应用程序类型的名称。

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

-ExcludeApplicationParameters

指定是否从查询结果中排除默认应用程序参数。

如果设置,默认应用程序参数字段仍可见,但为空。

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

-TimeoutSec

指定操作的超时期限(以秒为单位)。

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

-UsePaging

指定是否使用此查询的分页版本。

如果此查询未分页,则返回的结果数受最大消息大小配置的限制。 如果未指定,并且应用程序类型过多而无法容纳到消息中,则查询将失败。 不会向用户返回任何结果。 如果查询已分页,则由于消息大小限制,因此不会删除结果,因为当需要并循环访问时,结果会分解成页面。 分页由查询在内部完成,无需执行其他步骤。

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

输入

System.String

输出

System.Object