Compartilhar via

Get-UMMailboxPIN

  • Artigo

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2007-06-28

O cmdlet Get-UMMailboxPIN retorna informações de uma caixa de correio do usuário habilitado para UM.

Sintaxe

Get-UMMailboxPin [-Identity <MailboxIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>]

Descrição detalhada

O cmdlet Get-UMMailboxPIN retorna informações calculadas a partir dos dados de PIN armazenados em formato criptografado na caixa de correio do usuário. Por meio do cmdlet Get-UMMailboxPIN , você pode exibir informações da caixa de correio do usuário. Você também pode usar esse cmdlet para mostrar se a caixa de correio ou o acesso do usuário foi bloqueado.

Para executar o cmdlet Get-UMMailboxPIN, você deve usar uma conta à qual esteja delegada a função de Administrador de Destinatários do Exchange.

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Microsoft Exchange Server 2007, consulte Considerações sobre permissão. 

Parâmetros

Parâmetro Necessário Tipo Descrição

Credential

Opcional

System.Management.Automation.PSCredential

Este parâmetro especifica o nome do usuário e a senha a ser usada para acessar o serviço de diretório do Active Directory.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Este parâmetro especifica o nome de domínio totalmente qualificado do controlador de domínio que grava essa alteração de configuração no Active Directory.

Identity

Opcional

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Este parâmetro especifica o identificador que pode ser usado para recuperar informações sobre a caixa de correio. As variáveis desse parâmetro incluem:

  • ADObjectID

  • GUID

  • DN

  • Domain\Account

  • UPN

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

IgnoreDefaultScope

Opcional

System.Management.Automation.SwitchParameter

Esse parâmetro instrui o comando a ignorar a configuração padrão de escopo de destinatário do Shell de Gerenciamento do Exchange e usar toda a floresta como escopo. Isso permite que o comando acesse objetos do Active Directory que não estejam atualmente no escopo padrão. O uso do parâmetro IgnoreDefaultScope introduz as seguintes restrições:

  • Você não pode usar o parâmetro DomainController. O comando usará automaticamente um servidor de catálogo global adequado.

  • Você pode usar o DN somente para o parâmetro Identity. Outras formas de identificação, como alias ou GUID, não são aceitas.

  • Você não pode usar os parâmetros OrganizationalUnit e Identity juntos.

  • Você não pode usar o parâmetro Credential.

ReadFromDomainController

Opcional

System.Management.Automation.SwitchParameter

Este parâmetro especifica se as informações do usuário serão lidas a partir de um controlador de domínio no domínio do usuário. Se você tiver definido o escopo do destinatário de modo a incluir todos os destinatários da floresta e não usar este parâmetro, as informações do usuário poderão ser lidas a partir de um catálogo global cujas informações estão desatualizadas. Se você não usar este parâmetro, várias leituras poderão ser necessárias para obter as informações. Por padrão, o escopo do destinatário é definido como o domínio que hospeda seus servidores Exchange.

ResultSize

Opcional

Microsoft.Exchange.Data.Unlimited

Este parâmetro permite especificar um número máximo de resultados a ser retornado. Se um número máximo não for especificado, o cmdlet retornará todos os resultados.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

 

Exceções

Exceções Descrição

 

 

Exemplo

O primeiro exemplo de código exibe as propriedades do PIN da caixa de correio de Unificação de Mensagens para todos os usuários habilitados para UM.

O segundo exemplo de código exibe as propriedades relacionadas ao PIN da caixa de correio de Unificação de Mensagens para yanli@contoso.com.

Get-UMMailboxPIN

Get-UMMailboxPIN -Identity yanli@contoso.com