Identity

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

Tópico modificado em: 2006-08-10

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 determinado objeto no Microsoft Exchange Server 2007. Isso faz com que você possa executar ações em um determinado objeto do Exchange 2007.

O principal identificador exclusivo de um objeto é 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. Eles também são exclusivos naquele conjunto de objetos. É possível especificar os valores desses outros parâmetros, como Name e DistriguishedName e eles também 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. Supõe-se que o primeiro argumento de um cmdlet seja o parâmetro Identity quando nenhum outro rótulo do parâmetro esteja 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, pois Identity é um parâmetro de posição.

Get-ReceiveConnector -Identity "From the Internet"
Get-ReceiveConnector "From the Internet"

Como todos os objetos do Exchange 2007, esse conector de recebimento pode também ser referenciado por sua GUID exclusiva. Por exemplo, se o conector de recebimento chamado "From the Internet" também tiver atribuído a GUID 63d64005-42c5-4f8f-b310-14f6cb125bf3, você poderá recuperar também o conector de recebimento com o comando a seguir:

Get-ReceiveConnector 63d64005-42c5-4f8f-b310-14f6cb125bf3

Exemplos do parâmetro Identity

Os exemplos desta seção se referem a mensagens de notificação de status de entrega (DSN) que podem ser configuradas em uma organização do Exchange 2007. 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 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 2007 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.

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 2007. Esses exemplos ilustram também como o rótulo do parâmetro Identity pode ser omitido para reduzir o número de pressionamentos de teclas ao digitar comandos.