Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-04-22

Используйте командлет Import-RecipientDataProperty, чтобы добавить изображение или аудиофайл с именем пользователя к почтовому ящику или контакту. Файл с изображением и аудиофайл отображаются в диалоговом окне свойств Глобальный список адресов, в карточке контакта, в области чтения и в приглашениях на собрания в приложениях Microsoft Outlook 2010 и Microsoft Office Outlook Web App.

Синтаксис

Import-RecipientDataProperty -Identity <MailboxUserContactIdParameter> -FileData <Byte[]> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Picture <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Import-RecipientDataProperty -Identity <MailboxUserContactIdParameter> -FileData <Byte[]> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-SpokenName <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Параметры

Параметр Обязательный Тип Описание

FileData

Обязательный

System.Byte[]

Параметр FileData указывает расположение и имя файла изображения или аудиофайла. Дополнительные сведения о синтаксисе этого параметра см. в разделе Общие сведения об импорте и экспорте файлов в командной консоли Exchange.

Identity

Обязательный

Microsoft.Exchange.Configuration.Tasks.MailboxUserContactIdParameter

Параметр Identity указывает почтовый ящик или контакт, к которому добавляется изображение или аудиозапись имени. Можно использовать одно из следующих значений:

  • Псевдоним

  • Каноническое имя

  • Краткое имя

  • Различающееся имя (DN),

  • Различающееся имя Exchange

  • GUID

  • Имя

  • Основной адрес электронной почты SMTP

Confirm

Необязательный

System.Management.Automation.SwitchParameter

Параметр Confirm приостанавливает обработку и требует указать действие, которое будет выполнено командой перед ее возобновлением. Указывать значение параметра Confirm не обязательно.

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

Параметр DomainController указывает имя FQDN контроллера домена, который записывает это изменение конфигурации в Служба каталогов Active Directory.

Picture

Необязательный

System.Management.Automation.SwitchParameter

Параметр Picture указывает на то, что импортируемый файл является изображением. Файл изображения должен иметь формат JPEG, а его размер не должен превышать 10 КБ. Этот параметр нельзя использовать в сочетании с параметром SpokenName. За один раз можно импортировать только один тип файла.

SpokenName

Необязательный

System.Management.Automation.SwitchParameter

Параметр SpokenName указывает на то, что импортируемый файл является аудиофайлом. Максимальный размер файла не должен превышать 32 КБ. Можно использовать один из следующих форматов:

  • WMA 9-voice

  • PCM 8 кГц, 16 бит, Моно

Этот параметр нельзя использовать совместно с параметром Picture. За один раз можно импортировать только один тип файла.

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять с объектом. С помощью параметра WhatIf можно просмотреть изменения, которые могут произойти, не применяя эти изменения. Указывать значение параметра WhatIf не обязательно.

Подробное описание

Импорт и экспорт файлов требует особого синтаксиса, так как эти операции используют Remote PowerShell. Дополнительные сведения см. в разделе Общие сведения об импорте и экспорте файлов в командной консоли Exchange.

Для запуска этого командлета необходимы соответствующие разрешения. В этом разделе перечислены все параметры командлета, однако некоторые из них могут быть недоступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях см. в разделе Запись «Свойства данных получателя» в разделе Разрешения для почтового ящика.

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

 

Примеры

ПРИМЕР 1

В этом примере выполняется импорт аудиофайла звучания имени пользователя Tony Smith.

Скопировать код 
Import-RecipientDataProperty -Identity "Tony Smith" -SpokenName -FileData ([Byte[]]$(Get-Content -Path "M:\AudioFiles\TonySmith.wma" -Encoding Byte -ReadCount 0))

ПРИМЕР 2

В этом примере выполняется импорт изображения для пользователя Ayla Kol.

Скопировать код 
Import-RecipientDataProperty -Identity Ayla -Picture -FileData ([Byte[]]$(Get-Content -Path "M:\Employee Photos\AylaKol.jpg" -Encoding Byte -ReadCount 0))