Get-Contact
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2010-04-27
Use o cmdlet Get-Contact para recuperar informações sobre um ou mais contatos especificados.
Sintaxe
Get-Contact [-Identity <ContactIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Contact [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Contact [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Descrição detalhada
O cmdlet Get-Contact consulta as propriedades de um contato específico ou de objetos de destinatário de contato no serviço de diretório do Active Directory.
Para executar o cmdlet Get-Contact, você deve usar uma conta à qual esteja delegado o seguinte:
- Função Administrador Somente para Exibição do Exchange
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 |
|---|---|---|---|
Anr |
Opcional |
System.String |
O parâmetro Anr é usado para pesquisar objetos que correspondam a uma cadeia de caracteres parcial fornecida. É semelhante a uma pesquisa que use caracteres curinga. |
Credential |
Opcional |
System.Management.Automation.PSCredential |
O parâmetro Credential especifica a conta usada para consultar credenciais do contato no Active Directory. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Para especificar 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. |
Filter |
Opcional |
System.String |
O parâmetro Filter especifica um conjunto de atributos usado para restringir os destinatários retornados pela consulta. Para obter mais informações sobre as propriedades filtráveis, consulte Propriedades filtráveis do parâmetro -Filter. |
Identity |
Opcional |
Microsoft.Exchange.Configuration.Tasks.ContactIdParameter |
O parâmetro Identity adota um dos seguintes valores:
|
IgnoreDefaultScope |
Optional |
System.Management.Automation.SwitchParameter |
O parâmetro IgnoreDefaultScope instrui o comando a ignorar a configuração padrão de escopo do destinatário do Shell de Gerenciamento do Exchange e usar toda a floresta como o escopo. Isso permite que o comando acesse objetos do Active Directory que não estão atualmente no escopo padrão. O uso do parâmetro IgnoreDefaultScope introduz as seguintes restrições:
|
OrganizationalUnit |
Opcional |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
O parâmetro OrganizationalUnit retorna objetos somente da unidade organizacional (UO) especificada. |
ReadFromDomainController |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro ReadFromDomainController especifica se as informações do usuário são lidas a partir de um controlador de domínio no domínio do usuário. Se você definir o escopo do destinatário para incluir todos os destinatários da floresta e não usar este parâmetro, talvez as informações do usuário sejam lidas a partir de um catálogo global com informações desatualizadas. Se você usar este parâmetro, várias leituras poderão ser necessárias para obter as informações. Dica Por padrão, o escopo do destinatário é definido como o domínio que hospeda seus servidores Exchange. |
RecipientTypeDetails |
Opcional |
Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[] |
O parâmetro RecipientTypeDetails especifica o tipo de destinatários que são retornados. Os tipos de destinatários no Microsoft Exchange Server 2007 são divididos em tipos e subtipos de destinatários. Cada tipo de destinatário contém todas as propriedades comuns para todos os subtipos. Por exemplo, o tipo UserMailbox representa uma conta de usuário no Active Directory com uma caixa de correio associada. Como há vários tipos de caixas de correio, cada tipo é identificado pelo parâmetro RecipientTypeDetails. Por exemplo, uma caixa de correio de sala de conferência tem RecipientTypeDetails definido como ConferenceRoomMailbox, enquanto uma caixa de correio de usuário tem RecipientTypeDetails definido como UserMailbox. Para este comando, os detalhes de tipo de destinatário disponíveis são:
|
ResultSize |
Opcional |
Microsoft.Exchange.Data.Unlimited |
O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. |
SortBy |
Opcional |
System.String |
O parâmetro SortBy especifica que deverá ser feita uma classificação por um único atributo em ordem crescente. |
Tipos de entrada
Tipos de retorno
Erros
| Erro | Descrição |
|---|---|
|
|
Exceções
| Exceções | Descrição |
|---|---|
|
Exemplo
Nesse exemplo, o comando Get-Contact recupera o contato Ted Bremer e canaliza o objeto para o comando Format-List para exibir as informações sobre o contato.
Get-Contact -Identity TedBremer | Format-List