Get-CmdletExtensionAgent

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Get-CmdletExtensionAgent para exibir agentes de extensão de cmdlet.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Get-CmdletExtensionAgent
   [-Assembly <String>]
   [-Enabled <Boolean>]
   [-DomainController <Fqdn>]
   [<CommonParameters>]
Get-CmdletExtensionAgent
   [[-Identity] <CmdletExtensionAgentIdParameter>]
   [-DomainController <Fqdn>]
   [<CommonParameters>]

Description

Os agentes de extensão de cmdlet são usados pelos cmdlets do Exchange em Exchange Server 2010 e posteriores. Os cmdlets fornecidos por outros Microsoft ou produtos de terceiros não podem usar agentes de extensão de cmdlet.

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.

Exemplos

Exemplo 1

Get-CmdletExtensionAgent | Format-Table -Auto Name,Enabled,Priority

Este exemplo exibe uma lista resumida de todos os agentes de extensão do cmdlet na organização.

Exemplo 2

Get-CmdletExtensionAgent "Mailbox Creation Time Agent"

Este exemplo exibe informações detalhadas para o agente de extensão de cmdlet do Exchange chamado Agente de Tempo de Criação da Caixa de Correio.

Parâmetros

-Assembly

O parâmetro Assembly filtra os resultados pelo valor especificado da propriedade Assembly. O valor dos agentes de extensão de cmdlet do Exchange internos é Microsoft.Exchange.ProvisioningAgent.dll.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Enabled

O parâmetro Enabled filtra os resultados por agentes de extensão de cmdlet habilitados ou desabilitados. Os valores válidos são:

  • $true: somente agentes habilitados são incluídos nos resultados.
  • $false: somente agentes desabilitados são incluídos nos resultados.

Se você não usar esse parâmetro, os agentes habilitados e desabilitados são incluídos nos resultados.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

O parâmetro Identity especifica o nome do agente de extensão do cmdlet que você deseja exibir. É possível usar qualquer valor que identifique o agente com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID
Type:CmdletExtensionAgentIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Entradas

Input types

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.

Saídas

Output types

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.