Identidade

Aplica-se a: Exchange Server 2013

O parâmetro Identity é um parâmetro especial que você pode usar com a maioria dos cmdlets. O parâmetro Identity fornece acesso aos identificadores exclusivos que se referem a um objeto específico no Microsoft Exchange Server 2013. Essa funcionalidade permite que você execute ações em um objeto específico do Exchange 2013.

As seções a seguir descrevem o parâmetro Identity e fornecem exemplos de como você pode usá-lo efetivamente:

Características do parâmetro Identity

Caracteres curinga em Identidade

Exemplos do parâmetro Identity

Características do parâmetro Identity

O identificador exclusivo primário de um objeto no Exchange 2013 é sempre um GUID. Um GUID é um identificador de 128 bits, como 63d64005-42c5-4f8f-b310-14f6cb125bf3. Esse GUID nunca se repete e, portanto, é sempre exclusivo. No entanto, você não deseja digitar esses GUIDs regularmente. Portanto, o parâmetro Identity normalmente também consiste nos valores de outros parâmetros ou conjunto combinado de valores de vários parâmetros em um único objeto. Esses valores também têm a garantia de serem exclusivos nesse conjunto de objetos. Você pode especificar os valores desses outros parâmetros, como Nome e DistriguishedName, ou eles podem ser gerados pelo sistema. Os parâmetros adicionais que são usados, se houver e como eles são preenchidos, dependem do objeto ao qual você se refere.

O parâmetro Identity também é considerado um parâmetro posicional. O primeiro argumento em um cmdlet é considerado o parâmetro Identity quando nenhum rótulo de parâmetro é especificado. Isso reduz o número de teclas ao digitar comandos. Para obter mais informações sobre parâmetros de posição, consulte Parameters.

O exemplo a seguir mostra o uso do parâmetro Identity usando o valor exclusivo do parâmetro Nome do conector de recebimento. Este exemplo também mostra como você pode omitir o nome do parâmetro Identity porque Identity é um parâmetro posicional.

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

Como todos os objetos no Exchange 2013, esse conector de Recebimento também pode ser chamado pelo GUID exclusivo. Por exemplo, se o conector De recebimento nomeado "From the Internet" também receber o GUID 63d64005-42c5-4f8f-b310-14f6cb125bf3, você também poderá recuperar o conector Receber usando o seguinte comando:

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

Caracteres curinga em Identidade

Alguns cmdlets Get podem aceitar um caractere curinga (*) como parte do valor que você envia à Identidade ao executar o cmdlet. Usando um curinga com o parâmetro Identity , você pode especificar um nome parcial e recuperar uma lista de objetos que correspondam a esse nome parcial. Você pode colocar um caractere curinga no início ou no final do valor identity , mas não pode colocar o caractere no meio de uma cadeia de caracteres. Por exemplo, os comandos e Get-Mailbox _anders* são válidosGet-Mailbox David*, mas Get-Mailbox Reb*ca não são um comando válido.

Alguns cmdlets Get recuperam objetos no Exchange 2013 organizados em uma relação hierárquica ou pai e filhos. Ou seja, pode haver uma coleção de objetos pai que também contêm seus próprios objetos filho. Objetos que têm uma relação pai e filho podem ter uma Identidade com a sintaxe de <parent>\<child>.

Quando um parâmetro Identity tem uma sintaxe de <parent>\<child>, alguns cmdlets permitem que você use um caractere curinga (*) para substituir todos ou alguns dos nomes pai ou filho. Por exemplo, se você quiser encontrar todos os objetos filho chamados "Contoso" em todos os objetos pai, poderá usar a sintaxe "*\Contoso". Da mesma forma, se você quiser encontrar todos os objetos filho com um nome parcial de "Auth" que existem sob o "ServerA" objeto pai, você poderá usar a sintaxe "ServerA\Auth*".

Alguns cmdlets, mas não todos, permitem especificar apenas a parte filho do parâmetro Identity quando você executa um comando. Quando você faz isso, os cmdlets são padrão para o objeto pai atual que está sendo acessado. Por exemplo, dois conectores de recebimento chamados "Contoso Receive Connector" existem no MBX1 e no MBX2. Se você executar o comando Get-ReceiveConnector "Contoso Receive Connector" no MBX2, somente o conector de recebimento no MBX2 do servidor será retornado.

O comportamento específico do parâmetro Identity e caracteres curinga depende do cmdlet que está sendo executado. Para obter mais informações sobre o cmdlet que você está executando, consulte o conteúdo específico do recurso para esse cmdlet.

Exemplos do parâmetro Identity

Os exemplos descritos neste tópico ilustram como o parâmetro Identity pode aceitar valores exclusivos diferentes para se referir a objetos específicos na organização do Exchange 2013. Esses exemplos também ilustram como o rótulo de parâmetro Identity pode ser omitido para reduzir o número de teclas quando você digita comandos.

Mensagens de DSN

Os exemplos nesta seção referem-se às mensagens DSN (notificação de status de entrega) que podem ser configuradas em uma organização do Exchange 2013. 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 configuradas em cada objeto de mensagem DSN. Esses dados incluem o idioma no qual o DSN está escrito, se o DSN é interno ou externo no escopo e o código de mensagem DSN como no exemplo a seguir:

Get-SystemMessage en\internal\5.4.1

Você também pode recuperar essa mensagem DSN usando seu GUID como no exemplo a seguir, pois todos os objetos no Exchange 2013 têm um GUID:

Get-SystemMessage 82ca7bde-1c2d-4aa1-97e1-f298a6f10222

Para obter mais informações sobre a composição do parâmetro Identity quando ele for usado com os cmdlets SystemMessage , consulte Identidade de 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 funções de gerenciamento no Exchange 2013. As funções de gerenciamento são usadas para controlar as permissões concedidas aos administradores e usuários finais. As entradas de função de gerenciamento são compostas por duas partes: a função de gerenciamento à qual estão associadas e um cmdlet. O parâmetro Identity também é composto pelo nome da função de gerenciamento e pelo nome do cmdlet. Por exemplo, o seguinte é a entrada de função para o cmdlet Set-Mailbox na Mail Recipients função:

Mail Recipients\Set-Mailbox

A Mail Recipients\Set-Mailbox entrada de função é uma das várias entradas na Mail Recipients função. Para exibir todas as entradas de função na Mail Recipients função, você pode usar o seguinte comando:

Get-ManagementRoleEntry "Mail Recipients\*"

Para exibir todas as entradas de função na Mail Recipients função que contém a cadeia de caracteres "Mailbox", use o seguinte comando:

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 seguinte comando:

Get-ManagementRoleEntry *\Set-Mailbox

Com entradas de função, você pode usar o caractere curinga de várias maneiras de consultar o Exchange 2013 para obter as informações que você está interessado.

Para obter mais informações sobre funções de gerenciamento, consulte Noções básicas sobre funções de gerenciamento.