Remove-UserPhoto

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

Использование командлета Remove-UserPhoto для удаления фотографий, связанных с учетной записью пользователя. С помощью функции фотографий пользователя можно назначить изображение своей учетной записи. Фотографии пользователей отображаются в локальных и облачных клиентских приложениях, таких как Outlook в Интернете (прежнее название — Outlook Web App или OWA), Lync, Skype для бизнеса и SharePoint.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Remove-UserPhoto
      [-Identity] <MailboxIdParameter>
      [-Confirm]
      [-DomainController <Fqdn>]
      [-IgnoreDefaultScope]
      [-WhatIf]
      [<CommonParameters>]

Remove-UserPhoto
      [-Identity] <MailboxIdParameter>
      [-ClearMailboxPhotoRecord]
      [-GroupMailbox]
      [-PhotoType <String>]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-IgnoreDefaultScope]
      [-WhatIf]
      [<CommonParameters>]

Описание

Используйте командлет Remove-UserPhoto, чтобы удалить фотографию пользователя, связанную с учетной записью пользователя. Этот командлет удаляет фотографию из корневого каталога почтового ящика Exchange пользователя. В локальной среде Exchange фотография пользователя также удаляется из учетной записи Active Directory. Администраторы также могут использовать Центр администрирования Exchange (EAC) для удаления фотографий пользователей, перейдя на страницу Параметры в почтовом ящике пользователя в Outlook в Интернете.

Примечания.

Изменения фотографии пользователя не будут отображаться в SharePoint до тех пор, пока затронутый пользователь не перейдет на страницу своего профиля (личный сайт) или любую страницу SharePoint с большим эскизом.
В Microsoft Graph также доступен командлет Update-MgUserPhoto .

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Remove-UserPhoto "Ann Beebe"

В этом примере показано удаление фотографии, связанной с учетной записью пользователя Анна Белова.

Параметры

-ClearMailboxPhotoRecord

Переключатель ClearMailboxPhoto указывает на то, что удаленная фотография почтового ящика считается пустой, а не удаленной. Для этого переключателя не требуется указывать значение.

По умолчанию, когда пользователь удаляет фото почтового ящика, этот почтовый ящик помечается. Это вызывает появление запросов фото, чтобы:

возвратить пустую фотографию;
Запретить поиск фотографии в Active Directory.

Этот параметр позволяет запрашивать фотографии в Active Directory для поиска фотографии.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-Confirm

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

Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

Этот параметр доступен только в локальной среде Exchange.

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-GroupMailbox

Для изменения Группы Microsoft 365 требуется переключатель GroupMailbox. Для этого переключателя не требуется указывать значение.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

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

Имя
Псевдоним
различающееся имя (DN);
различающееся имя (DN);
Домен\Имя пользователя
Адрес электронной почты
GUID
LegacyExchangeDN
SamAccountName
Идентификатор пользователя или имя участника-пользователя

Type:	MailboxIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IgnoreDefaultScope

Параметр IgnoreDefaultScope указывает команде игнорировать параметр области получателя по умолчанию для сеанса Exchange PowerShell и использовать в качестве области весь лес. Указывать значение для этого параметра необязательно.

Этот параметр позволяет команде получать доступ к объектам Active Directory, которые в настоящее время недоступны в области по умолчанию, но также вводит следующие ограничения:

При этом параметр DomainController использовать нельзя. Команда автоматически использует соответствующий сервер глобального каталога.
При этом параметр DomainController использовать нельзя. Команда автоматически использует соответствующий сервер глобального каталога.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-PhotoType

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.