Get-MailboxPlan

Esse cmdlet só está disponível no serviço baseado em nuvem.

Use o cmdlet Get-MailboxPlan para exibir informações sobre os planos de caixa de correio no serviço baseado em nuvem. Observação : Recomendamos que você use o módulo do PowerShell v2 do Exchange Online para se conectar ao PowerShell do Exchange Online. Para obter instruções, confira Conectar-se ao PowerShell do Exchange Online (https://docs.microsoft.com/powershell/exchange/connect-to-exchange-online-powershell).

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax (https://docs.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).

Syntax

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

Description

Um plano de caixa de correio é um modelo que configura automaticamente as propriedades da caixa de correio. Os planos de caixa de correio correspondem aos tipos de licença e são aplicados quando você licencia o usuário. A disponibilidade de um plano de caixa de correio é determinada pelas suas seleções quando você se inscreve no serviço e na idade da sua organização.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Examples

Exemplo 1

Get-MailboxPlan

Este exemplo retorna uma lista resumida de todos os planos de caixa de correio na organização.

Exemplo 2

Get-MailboxPlan -Identity ExchangeOnlineEnterprise | Format-List

Este exemplo retorna informações detalhadas sobre o plano de caixa de correio que tem o nome de exibição ExchangeOnlineEnterprise.

Parameters

-AllMailboxPlanReleases

A opção AllMailboxPlanReleases especifica se é para incluir planos de caixa de correio que foram usados em versões anteriores do serviço nos resultados. Não é preciso especificar um valor com essa opção.

Se você não usar essa opção, o comando retornará apenas os planos de caixa de correio usados na versão atual do serviço. Esse parâmetro tem significado somente para organizações que foram registradas em versões anteriores do serviço.

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

O parâmetro Credential especifica o nome de usuário e a senha usados para executar este comando. Normalmente, você usa esse parâmetro em scripts ou quando você precisa fornecer credenciais diferentes que têm as permissões necessárias.

Um valor para esse parâmetro requer o cmdlet Get-Credential. Para pausar o comando e receber uma solicitação de credenciais, use o valor (Get-Credential). Ou, antes de executar esse comando, armazene as credenciais em uma variável (por exemplo, $cred = Get-Credential) e, em seguida, use o nome da variável ($cred) para esse parâmetro. Para saber mais, confira Obter credencial.

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

O parâmetro Filter usa a sintaxe OPath para filtrar os resultados de acordo com as propriedades e os valores especificados. Os critérios de pesquisa usam a sintaxe "Property -ComparisonOperator 'Value'" .

  • Coloque todo o filtro OPath entre aspas duplas "". Se o filtro contiver valores de sistema (por exemplo,, $true $false ou $null ), use aspas simples. Embora esse parâmetro seja uma cadeia de caracteres (não um bloco de sistema), você também pode usar chaves {}, mas somente se o filtro não contiver variáveis.

  • Propriedade é uma propriedade filtrável.

  • ComparisonOperator é um operador de comparação de OPath (por exemplo -eq , igual a e -like para comparação de cadeia de caracteres). Para obter mais informações sobre operadores de comparação, consulte about_Comparison_Operators.

  • Value é o valor da propriedade a ser pesquisada. Coloque valores de texto e variáveis entre aspas simples ( 'Value' ou '$Variable' ). Se um valor de variável contiver aspas simples, você precisará identificar (escapar) as aspas simples para expandir a variável corretamente. Por exemplo, em vez de '$User' , use '$($User -Replace "'","''")' . Não coloque números inteiros ou valores do sistema (por exemplo,,, 500 $true $false ou $null ).

Você pode encadear vários critérios de pesquisa juntos usando os operadores lógicos -and e -or . Por exemplo, "Criteria1 -and Criteria2" ou "(Criteria1 -and Criteria2) -or Criteria3" .

Para obter informações detalhadas sobre filtros do OPath no Exchange, consulte Additional OPATH Syntax Information.

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

O parâmetro Identity especifica o plano de caixa de correio que você deseja exibir. É possível usar qualquer valor que identifique o plano de caixa de correio com exclusividade. Por exemplo:

  • Nome

  • Alias

  • Nome

  • DN (nome diferenciado)

  • GUID

Type:MailboxPlanIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online
-IgnoreDefaultScope

Esse parâmetro está reservado para uso interno da Microsoft.

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

Esse parâmetro está reservado para uso interno da Microsoft.

Type:OrganizationalUnitIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-Resultados

O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. Caso pretenda retornar todas as solicitações correspondentes à consulta, use unlimited como valor desse parâmetro. O valor padrão é 1000.

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

O parâmetro SortBy especifica a propriedade pela qual classificar os resultados. Você pode classificar apenas por uma propriedade de cada vez. Os resultados são classificados em ordem crescente.

Se o modo de exibição padrão não incluir a propriedade que você está classificando, você pode anexar o comando com | Format-Table-auto <Property1> , <Property2> ... para criar um novo modo de exibição que contenha todas as propriedades que você deseja ver. Há suporte para caracteres curinga ( * ) nos nomes das propriedades.

Você pode classificar pelos seguintes atributos:

  • Alias

  • DisplayName

  • Nome

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

Inputs

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Outputs

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.