Get-UMActiveCalls (RTM)
Aplica-se a: Exchange Server 2007
Tópico modificado em: 2007-06-11
O cmdlet Get-UMActiveCalls retorna informações sobre as chamadas que estão ativas e sendo processadas pelo servidor de Unificação de Mensagens.
Sintaxe
Get-UMActiveCalls [-DomainController <Fqdn>] [-Server <ServerIdParameter>]
Get-UMActiveCalls -InstanceServer <UMServer> [-DomainController <Fqdn>]
Get-UMActiveCalls -DialPlan <UMDialPlanIdParameter> [-DomainController <Fqdn>]
Get-UMActiveCalls -IPGateway <UMIPGatewayIdParameter> [-DomainController <Fqdn>]
Descrição detalhada
O cmdlet Get-UMActiveCalls retorna informações sobre as chamadas ativas que estão sendo processadas. Se o cmdlet Get-UMActiveCalls especificar o plano de discagem do UM ou o gateway IP do UM, ele procurará no serviço de diretório do Active Directory para determinar com quais servidores de Unificação de Mensagens deve entrar em contato. Se o servidor de Unificação de Mensagens for especificado na linha de comando, o cmdlet Get-UMActiveCalls retornará as chamadas ativas que estiverem sendo processadas pelo servidor especificado.
Dica
Quando um servidor de Unificação de Mensagens estiver realizando o ciclo de processamento, o cmdlet Get-UMActiveCalls não retornará uma lista de todas as chamadas para o processo descontinuado e o processo ativo. Ele retornará somente as chamadas ativas para o novo processo.
Para executar o cmdlet Get-UMActiveCalls, você deve usar uma conta à qual esteja delegado o seguinte:
- Função de Administrador do Exchange Server e grupo Administradores local para o servidor de destino
Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange Server 2007, consulte Considerações sobre permissão.
Parâmetros
| Parâmetro | Necessário | Tipo | Descrição |
|---|---|---|---|
DialPlan |
Necessário |
Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter |
Este parâmetro especifica o plano de discagem do UM para o qual você deseja recuperar chamadas ativas. |
InstanceServer |
Necessário |
Microsoft.Exchange.Data.Directory.Management.UMServer |
Esse parâmetro especifica o servidor de Unificação de Mensagens para o qual você deseja recuperar chamadas ativas. |
IPGateway |
Necessário |
Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter |
Este parâmetro especifica o gateway IP do UM para o qual você deseja recuperar chamadas ativas. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Para que esse parâmetro especifique o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que recupera dados do Active Directory, inclua o parâmetro DomainController no comando. |
Server |
Opcional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Esse parâmetro especifica o servidor de Unificação de Mensagens para o qual você deseja recuperar chamadas ativas. |
Tipos de entrada
Tipos de retorno
Erros
| Erro | Descrição |
|---|---|
|
|
Exceções
| Exceções | Descrição |
|---|---|
|
|
Exemplo
O primeiro exemplo de código exibe os detalhes de todas as chamadas ativas no servidor local de Unificação de Mensagens.
O segundo exemplo de código exibe os detalhes de todas as chamadas ativas em um servidor de Unificação de Mensagens chamado MyUMServer.
O terceiro exemplo de código exibe detalhes de todas as chamadas ativas que estão sendo processadas por um gateway IP do UM chamado MyUMIPGateway.
O quarto exemplo de código exibe uma lista de chamadas ativas que estão associadas ao plano de discagem do UM chamado MyUMDialPlan.
Get-UMActiveCalls
Get-UMActiveCalls -Server MyUMServer
Get-UMActiveCalls -IPGateway MyUMIPGateway
Get-UMActiveCalls -DialPlan MyUMDialPlan