Применимо к: Exchange Server 2010 SP1
Последнее изменение раздела: 2011-04-24
Параметр Identity является специальным параметром, который можно использовать с большинством командлетов. Параметр Identity предоставляет доступ к уникальным идентификаторам, относящимся к конкретному объекту в системе Microsoft Exchange Server 2010. Это позволяет выполнять действия над конкретным объектом Exchange 2010.
В следующих разделах описывается параметр Identity и приведены примеры его эффективного использования:
Характеристики параметра Identity
Подстановочные знаки в параметре Identity
Примеры использования параметра Identity
Характеристики параметра
Identity
Основным уникальным идентификатором объекта в системе
Exchange 2010 всегда является GUID. GUID является 128-разрядным
идентификатором, например
63d64005-42c5-4f8f-b310-14f6cb125bf3. GUID никогда не
повторяется, поэтому этот идентификатор всегда является уникальным.
Но регулярно вводить такие идентификаторы GUID бывает
затруднительно. Поэтому параметр Identity, как правило,
также состоит из значений других параметров или объединенного
набора значений нескольких параметров одного объекта. Уникальность
этих значений также гарантируется в этом наборе объектов. Значения
этих других параметров, таких как Name и
DistriguishedName, можно задать, или они могут быть
сформированы системой. Дополнительные параметры (если они
используются) и способы заполнения их значений зависят от объектов,
к которым они относятся.
Кроме того, параметр Identity является позиционным параметром. Предполагается, что в отсутствие меток других параметров для командлета первым является параметр Identity. Это уменьшает количество нажатий клавиш при вводе команд. Дополнительные сведения о позиционных параметрах см. в разделе Параметры.
В следующем примере показано использование параметра Identity с применением уникального значения параметра Name для соединителя получения. В этом примере также иллюстрируется пропуск имени параметра Identity, поскольку параметр Identity является позиционным.
 Скопировать код |
|
|---|---|
Get-ReceiveConnector -Identity "From the Internet" Get-ReceiveConnector "From the Internet" |
|
Аналогично всем объектам в Exchange 2010, этот
соединитель получения также определяется своим уникальным
идентификатором GUID. Например, если соединителю получения с именем
"From the Internet" также назначен идентификатор GUID
63d64005-42c5-4f8f-b310-14f6cb125bf3, получить
соединитель получения можно с помощью следующей команды:
| Скопировать код |
|
|---|---|
Get-ReceiveConnector 63d64005-42c5-4f8f-b310-14f6cb125bf3 |
|
Подстановочные знаки в параметре
Identity
Некоторые командлеты Get при своем запуске могут
принимать подстановочный знак (*) как часть значения,
переданного в параметр Identity. Но использование с
параметром Identity подстановочного знака позволяет задать
часть имени и получить список объектов, соответствующих этой части
имени. Подстановочный знак можно поместить в начало или конец
значения Identity, но нельзя поместить знак в середину
строки. Например, команды Get-Mailbox David* и
Get-Mailbox *anders* являются допустимыми, а
Get-Mailbox Reb*ca — это недопустимая
команда.
Некоторые командлеты Get возвращают объекты
Exchange 2010, организованные с помощью иерархической связи или
связи «родитель-потомок». То есть, это могут быть коллекции
родительских объектов, которые также содержат соответствующие
дочерние объекты. У объектов, соединенных связью
«родитель-потомок», параметр Identity может использовать
синтаксис <parent>\<child>.
Когда для параметра Identity используется
синтаксис <parent>\<child>, некоторые
командлеты позволяют заменить подстановочным знаком (*) все или
некоторые имена родителей и потомков. Например, если нужно найти в
родительских объектах все дочерние объекты с именем «Contoso»,
можно использовать синтаксис "*\Contoso". Аналогично,
если нужно найти все дочерние объекты с частью имени «Auth»,
существующие для родительского объекта "ServerA" ,
можно использовать синтаксис "ServerA\Auth*".
Некоторые, но не все командлеты позволяют при
выполнении задать для параметра Identity только часть имени,
соответствующую дочернему объекту. В этом случае командлеты по
умолчанию используют текущий доступный родительский объект.
Например, пусть в каждом из серверов MBX1 и MBX2 существует
соединитель получения с именем «Contoso Receive Connector». Если
выполнить команду Get-ReceiveConnector "Contoso Receive
Connector" для MBX2, будет возвращен только соединитель
получения на сервере MBX2.
Конкретное поведение параметра Identity и подстановочных знаков зависит от выполняемого командлета. Дополнительные сведения о выполняемом командлете см. в описании функций этого командлета.
Примеры использования параметра
Identity
В примерах этого раздела иллюстрируется использование в параметре Identity различных уникальных значений для указания конкретных объектов в организации Exchange 2010. Кроме того, эти примеры показывают пропуск метки параметра Identity для уменьшения количества нажатий клавиш при вводе команд.
Уведомления о доставке
Примеры этого раздела ссылаются на уведомления о доставке, которые могут быть настроены в организации Exchange 2010. Первый пример иллюстрирует получение DSN 5.4.1 с помощью командлета Get-SystemMessage. В командлете Get-SystemMessage параметр Identity содержит несколько элементов данных, которые настроены для каждого объекта уведомления о доставке. К этим элементам данных относятся язык, на котором написано сообщение уведомление о доставке, элемент, определяющий, является уведомление о доставке внешним или внутренним в области действия, и код уведомления о доставке, как в следующем примере.
| Скопировать код |
|
|---|---|
Get-SystemMessage en\internal\5.4.1 |
|
Для доступа к этому уведомлению о доставке можно также использовать его идентификатор GUID (см. следующий пример), поскольку у всех объектов в Exchange 2010 есть GUID:
| Скопировать код |
|
|---|---|
Get-SystemMessage 82ca7bde-1c2d-4aa1-97e1-f298a6f10222 |
|
Дополнительные сведения о составе параметра Identity при его использовании с командлетами SystemMessage см. в разделе Идентификация сообщения DSN.
Записи ролей управления
В примерах этого раздела используются записи роли
управления, образующие роли управления в Exchange 2010. Роли
управления используются для управления разрешениями,
предоставляемыми администраторам и конечным пользователям. Записи
роли управления состоят из двух частей: роль управления, с которой
они связаны, и командлет. Аналогично, параметр Identity состоит из
имени роли управления и имени командлета. Например, ниже приведена
запись роли для командлета Set-Mailbox в
роли Mail Recipients:
| Скопировать код |
|
|---|---|
Mail Recipients\Set-Mailbox |
|
Запись роли Mail Recipients\Set-Mailbox —
это одна из нескольких записей в роли Mail Recipients.
Чтобы просмотреть все записи роли Mail Recipients,
можно использовать следующую команду:
| Скопировать код |
|
|---|---|
Get-ManagementRoleEntry "Mail Recipients\*" |
|
Чтобы просмотреть все записи роли Mail
Recipients, содержащие строку «Mailbox»,
используйте следующую команду:
| Скопировать код |
|
|---|---|
Get-ManagementRoleEntry "Mail Recipients\*Mailbox*" |
|
Чтобы просмотреть все роли управления, в которых одной из записей роли является Set-Mailbox, используется следующая команда:
| Скопировать код |
|
|---|---|
Get-ManagementRoleEntry *\Set-Mailbox |
|
С записями роли можно различным образом использовать подстановочный знак, чтобы запросить в Exchange 2010 нужные данные.
Дополнительные сведения о ролях управления см. в разделе Общие сведения о разрешениях.