Удостоверение
Область применения: Exchange Server 2013 г.
Параметр Identity — это специальный параметр, который можно использовать с большинством командлетов. Параметр Identity предоставляет доступ к уникальным идентификаторам, которые ссылаются на конкретный объект в Microsoft Exchange Server 2013 г. Эта возможность позволяет выполнять действия с определенным объектом Exchange 2013.
В следующих разделах описывается параметр Identity и приведены примеры его эффективного использования:
Характеристики параметра Identity
Подстановочные знаки в параметре Identity
Примеры использования параметра Identity
Характеристики параметра Identity
Основным уникальным идентификатором объекта в Exchange 2013 всегда является GUID. GUID — это 128-разрядный идентификатор, например 63d64005-42c5-4f8f-b310-14f6cb125bf3. Этот идентификатор никогда не повторяется, поэтому он всегда уникален. Но постоянно вводить такие идентификаторы не удобно. Поэтому параметр Identityобычно также состоит из значений других параметров или объединенного набора значений нескольких параметров одного объекта. Эти значения также гарантированно уникальны в этом наборе объектов. Значения этих других параметров, например Name и DistriguishedName, можно указать, или их может создать система. Дополнительные параметры (если они используются) и их заполнение зависят от объекта, к которому они относятся.
Параметр Identity также считается позиционным параметром. Если не указано другое, предполагается, что первый аргумент в командлете — это параметр Identity. Это уменьшает количество нажатий клавиш при вводе команд. Дополнительные сведения о позиционных параметрах см. в разделе Parameters.
В следующем примере показано использование параметра Identity с применением уникального значения параметра Name для соединителя получения. Кроме того, в нем показано, как опустить имя параметра Identity, так как параметр Identity является позиционным.
Get-ReceiveConnector -Identity "From the Internet"
Get-ReceiveConnector "From the Internet"
Как и все объекты в Exchange 2013, этот соединитель получения также можно ссылаться по уникальному ИДЕНТИФИКАТОРу GUID. Например, если соединителю получения с именем "From the Internet" также назначен GUID 63d64005-42c5-4f8f-b310-14f6cb125bf3, то соединитель получения также можно получить с помощью следующей команды:
Get-ReceiveConnector 63d64005-42c5-4f8f-b310-14f6cb125bf3
Подстановочные знаки в параметре Identity
Некоторые командлеты Get могут принимать подстановочный знак (*) в качестве части значения, которое вы отправляете в identity при выполнении командлета. Используя подстановочный знак с параметром Identity, можно указать часть имени и получить список объектов, соответствующих этой части имени. Подстановочный знак можно поместить в начало или конец значения Identity, но не в середину строки. Например, команды и Get-Mailbox _anders* являются допустимымиGet-Mailbox David*, но Get-Mailbox Reb*ca не являются допустимыми.
Некоторые командлеты Get извлекают объекты в Exchange 2013, упорядоченные в иерархическом или родительском и дочернем отношениях. То есть это могут быть коллекции родительских объектов, которые также содержат соответствующие дочерние объекты. Объекты с родительским и дочерним отношениями могут иметь удостоверение с синтаксисом <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 2013. Кроме того, в этих примерах показано, как опустить метку параметра Identity для уменьшения количества нажатий клавиш при вводе команд.
уведомления о доставке;
Примеры в этом разделе относятся к сообщениям о состоянии доставки (DSN), которые можно настроить в организации Exchange 2013. В первом примере показано, как получить сообщение DSN 5.4.1 с помощью командлета Get-SystemMessage. В командлете Get-SystemMessage параметр Identity состоит из нескольких элементов данных, которые настроены для каждого объекта сообщения DSN. К этим элементам относится язык сообщения DSN, его область (внешняя или внутренняя) и код, как показано в следующем примере:
Get-SystemMessage en\internal\5.4.1
Это сообщение DSN также можно получить с помощью идентификатора GUID, как показано в следующем примере, так как все объекты в Exchange 2013 имеют GUID:
Get-SystemMessage 82ca7bde-1c2d-4aa1-97e1-f298a6f10222
Дополнительные сведения о составе параметра Identity при его использовании с командлетами SystemMessage см. в разделе Удостоверение сообщения DSN.
Записи ролей управления
Примеры в этом разделе относятся к записям ролей управления, которые составляют роли управления в Exchange 2013. Роли управления используются для управления разрешениями, которые предоставляются администраторам и конечным пользователям. Записи ролей управления состоят из двух частей: роли управления, с которой они связаны, и командлета. Аналогично, параметр 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 2013.
Дополнительные сведения о ролях управления см. в разделе Общие сведения о ролях управления.