Identidade
Aplica-se a: Exchange Server 2010 SP2, Exchange Server 2010 SP3
Tópico modificado em: 2012-02-03
O parâmetro Identity é um parâmetro especial que pode ser usado na maioria dos cmdlets. O parâmetro Identity fornece acesso aos identificadores exclusivos que fazem referência a um objeto específico no Microsoft Exchange Server 2010. Essa capacidade permite executar ações em um objeto específico do Exchange 2010.
As seções a seguir descrevem o parâmetro Identity e fornecem exemplos de como usá-lo com eficiência.
Características do parâmetro Identity
Caracteres curinga em identidade
Exemplos do parâmetro Identity
Características do parâmetro Identity
O principal identificador exclusivo de um objeto no Exchange 2010 é sempre uma GUID. Uma GUID é um identificador de 128 bits, como 63d64005-42c5-4f8f-b310-14f6cb125bf3. Essa GUID nunca se repete e portanto é sempre exclusiva. Entretanto, não é razoável digitar essas GUIDs regularmente. Portanto, o parâmetro Identity normalmente consiste também nos valores de outros parâmetros ou no conjunto de valores de vários parâmetros combinados em um único objeto. Esses valores também são exclusivos naquele conjunto de objetos. Você pode especificar os valores desses outros parâmetros, como Name e DistinguishedName ou então eles podem ser gerados pelo sistema. Os parâmetros adicionais usados e como eles são preenchidos dependem do objeto a que se referem.
O parâmetro Identity também é considerado um parâmetro de posição. Presume-se que o primeiro argumento de um cmdlet seja o parâmetro Identity quando nenhum outro rótulo do parâmetro estiver especificado. Isso reduz o número de pressionamentos de teclas ao digitar comandos. Para obter mais informações sobre parâmetros de posição, consulte Parâmetros.
O exemplo a seguir mostra o uso do parâmetro Identity usando o valor do parâmetro Name exclusivo do conector de recebimento. Este exemplo também mostra como você pode omitir o nome do parâmetro Identity, pelo fato de Identity ser um parâmetro de posição.
Get-ReceiveConnector -Identity "From the Internet"
Get-ReceiveConnector "From the Internet"
Como todos os objetos do Exchange 2010, esse conector de recebimento pode também ser referenciado por sua GUID exclusiva. Por exemplo, se o conector de recebimento denominado "From the Internet" também tiver atribuído a GUID 63d64005-42c5-4f8f-b310-14f6cb125bf3, você também poderá recuperar o conector de recebimento usando o comando a seguir:
Get-ReceiveConnector 63d64005-42c5-4f8f-b310-14f6cb125bf3
Voltar ao início
Caracteres curinga em identidade
Alguns cmdlets Get podem aceitar caractere curinga (*) como parte do valor enviado a Identity ao executar o cmdlet. Usando um caractere curinga com o parâmetro Identity, você pode especificar um nome parcial e recuperar uma lista de objetos que corresponda a esse nome parcial. Você pode colocar um caractere curinga no início ou no final do valor de Identity, mas não pode colocá-lo no meio de uma cadeia de caracteres. Por exemplo, comandos Get-Mailbox David* e Get-Mailbox *anders* são válidos, mas Get-Mailbox Reb*ca não é um comando válido.
Alguns cmdlets Get recuperam objetos no Exchange 2010 que estejam organizados hierarquicamente ou em uma relação pais e filhos. Isto é, pode haver uma coleção de objetos pais que contenham seus próprios objetos filhos. Objetos que tenham uma relação pai e filho podem ter uma Identity com a sintaxe de <parent>\<child>.
Quando um parâmetro Identity tiver uma sintaxe de <parent>\<child>, alguns cmdlets permitirão usar um caractere curinga (*) para substituir todos ou alguns dos nomes pais ou filhos. Por exemplo, se deseja encontrar todos os objetos filhos denominados "Contoso" em todos os objetos pais, você poderia usar a sintaxe "*\Contoso". Da mesma forma, se deseja encontrar todos os objetos filhos com o nome parcial de "Auten" existente em um objeto pai "ServerA" , você poderia usar a sintaxe "ServerA\Auth*".
Alguns, mas não todos, cmdlets permitem especificar apenas a porção filho do parâmetro Identity ao executar um comando. Ao fazer isso, os cmdlets assumem como padrão o objeto pai que está sendo acesso no momento. Por exemplo, dois conectores de recebimento, denominados "Conector de Recebimento Contoso", existem tanto no MBX1 como no MBX2. Se você executar o comando Get-ReceiveConnector "Contoso Receive Connector" no MBX2, somente o conector de recebimento é retornado no MBX2 do servidor.
O comportamento específico do parâmetro Identity e dos caracteres curinga é dependente do cmdlet em execução. Para obter mais informações sobre o cmdlet em execução, consulte o conteúdo específico do recurso desse cmdlet.
Voltar ao início
Exemplos do parâmetro Identity
Os exemplos descritos neste tópico ilustram como o parâmetro Identity pode aceitar diferentes valores exclusivos para fazer referência a objetos específicos na organização do Exchange 2010. Esses exemplos ilustram também como o rótulo do parâmetro Identity pode ser omitido para reduzir o número de pressionamentos de tecla ao digitar comandos.
Mensagens de DSN
Os exemplos desta seção se referem a mensagens de DSN (notificação de status de entrega) que podem ser configuradas em uma organização do Exchange 2010. O primeiro exemplo mostra como recuperar o DSN 5.4.1 usando o cmdlet Get-SystemMessage. No cmdlet Get-SystemMessage, o parâmetro Identity consiste em várias partes de dados configurados em cada objeto de mensagem de DSN. Essas partes de dados incluem a linguagem em que o DSN foi escrito, se o DSN é interno ou externo em seu escopo e o código da mensagem DSN, conforme mostra o seguinte exemplo:
Get-SystemMessage en\internal\5.4.1
Também é possível recuperar essa mensagem de DSN usando sua GUID, conforme mostra o exemplo a seguir, porque todos os objetos no Exchange 2010 possuem uma GUID:
Get-SystemMessage 82ca7bde-1c2d-4aa1-97e1-f298a6f10222
Para obter mais informações sobre o parâmetro Identity quando ele é usado com os cmdlets SystemMessage, consulte Identidade de uma mensagem DSN.
Entradas de Função de Gerenciamento
Os exemplos nesta seção referem-se a entradas de função de gerenciamento que compõem as funções de gerenciamento no Exchange 2010. Funções de gerenciamento são usadas para controlar as permissões concedidas a administradores e usuários finais. Gerenciamento de função entradas são compostas de duas partes: a função de gerenciamento que estão associados e um cmdlet. Da mesma forma, o parâmetro Identity é composto do nome da função de gerenciamento e do nome do cmdlet. O exemplo a seguir mostra uma entrada de função do cmdlet Set-Mailbox na função Mail Recipients:
Mail Recipients\Set-Mailbox
A entrada de função Mail Recipients\Set-Mailbox é uma das várias de entradas na função Mail Recipients. Para exibir todas as entradas de função na função Mail Recipients, use o comando a seguir:
Get-ManagementRoleEntry "Mail Recipients\*"
Para exibir todas as entradas de função na função Mail Recipients contendo a cadeia de caracteres "Mailbox", use o comando a seguir:
Get-ManagementRoleEntry "Mail Recipients\*Mailbox*"
Para exibir todas as funções de gerenciamento em que Set-Mailbox é uma das entradas de função, use o comando a seguir:
Get-ManagementRoleEntry *\Set-Mailbox
Com entradas de função é possível usar caractere curinga de várias formas para consultar informações de seu interesse no Exchange 2010.
Para obter mais informações sobre as funções de gerenciamento, consulte Entendendo as Permissões.
Voltar ao início