Get-MailboxPlan

此 cmdlet 仅在基于云的服务中可用。

使用 Get-MailboxPlan cmdlet 查看有关基于云的服务中的邮箱计划的信息。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

Get-MailboxPlan
   [[-Identity] <MailboxPlanIdParameter>]
   [-AllMailboxPlanReleases]
   [-Credential <PSCredential>]
   [-Filter <String>]
   [-IgnoreDefaultScope]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [<CommonParameters>]

说明

邮箱计划是自动配置邮箱属性的模板。 邮箱计划对应于许可证类型,并在为用户授予许可时应用。 邮箱计划的可用性取决于你在服务中注册时的选择以及组织的年龄。

您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

示例

示例 1

Get-MailboxPlan

本示例将返回组织中所有邮箱计划的摘要列表。

示例 2

Get-MailboxPlan -Identity ExchangeOnlineEnterprise | Format-List

本示例将返回具有显示名称“ExchangeOnlineEnterprise”的邮箱计划的详细信息。

参数

-AllMailboxPlanReleases

AllMailboxPlanReleases 开关指定是否在结果中包含以前版本的服务中使用的邮箱计划。 不必为此开关指定值。

如果不使用此开关,该命令仅返回当前版本的服务中使用的邮箱计划。 此参数仅对在以前版本的服务中注册的组织有意义。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Credential

Credential 参数指定用于运行此命令的用户名和密码。 通常情况下,您可以在脚本中或在需要提供具有所需权限的不同凭据时使用此参数。

此参数的值需要 Get-Credential cmdlet。 要暂停此命令并接收凭据提示,请使用值 (Get-Credential)。 或者,在运行此命令之前,请将凭据存储在变量(例如,$cred = Get-Credential)中,然后将变量名称 ($cred) 用作此参数。 有关详细信息,请参阅 Get-Credential

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Filter

Filter 参数使用 OPATH 语法按指定的属性和值筛选结果。 搜索条件使用 语法 "Property -ComparisonOperator 'Value'"

  • 将整个 OPATH 筛选器括在双引号“”中。 如果筛选器包含系统值 (,例如 $true$false$null) ,请改用单引号 ' 。 虽然此参数是一个字符串 (不是) 的系统块,但也可以使用大括号 { },但前提是筛选器不包含变量。
  • 属性是可筛选的属性。 有关 Exchange server 和 Exchange Online 中的可筛选属性的详细信息,请参阅 Filterable properties for the Filter 参数
  • ComparisonOperator 是一个 OPATH 比较运算符, (例如 -eq 用于等于和 -like 字符串比较) 。 有关比较运算符的详细信息,请参阅 about_Comparison_Operators
  • Value 是要搜索的属性值。 将文本值和变量括在单引号 ('Value''$Variable') 。 如果变量值包含单引号,则需要识别 (转义) 单引号才能正确展开变量。 例如,使用 '$($User -Replace "'","''")'而不是 '$User'。 不要将整数或系统值括在引号 (例如,改用 500$true$false$null) 。

可以使用逻辑运算符 -and-or将多个搜索条件链接在一起。 例如,"Criteria1 -and Criteria2""(Criteria1 -and Criteria2) -or Criteria3"

有关 Exchange 中的 OPATH 筛选器的详细信息,请参阅 其他 OPATH 语法信息

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Identity

Identity 参数指定要查看的邮箱计划。 可以使用任何能够唯一标识该邮箱计划的值。 例如:

  • 名称
  • 别名
  • 显示名称
  • 可分辨名称 (DN)
  • GUID
Type:MailboxPlanIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-IgnoreDefaultScope

保留此参数以供 Microsoft 内部使用。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ResultSize

ResultSize 参数指定了要返回的结果的最大数量。 若要返回所有与查询相匹配的请求,则请将此参数的值设为无限制。 默认值为 1000。

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SortBy

SortBy 参数指定用作结果排序依据的属性。 每次只能按一个属性进行排序。 结果将按升序进行排序。

如果默认视图不包括要排序依据的属性,则可以使用 | Format-Table -Auto Property1,Property2,...PropertyX追加命令。 创建包含要查看的所有属性的新视图。 支持在属性名称中使用通配符 (*)。

可以按下列属性排序:

  • Alias
  • DisplayName
  • 名称
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

输入

Input types

若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。