Get-UserPhoto

Синтаксис

AnrSet

Get-UserPhoto
    [-Anr <String>]
    [-Credential <PSCredential>]
    [-DomainController <Fqdn>]
    [-Filter <String>]
    [-GroupMailbox]
    [-IgnoreDefaultScope]
    [-OrganizationalUnit <OrganizationalUnitIdParameter>]
    [-PhotoType <String>]
    [-Preview]
    [-ReadFromDomainController]
    [-ResultSize <Unlimited>]
    [-SortBy <String>]
    [<CommonParameters>]

Identity

Get-UserPhoto
    [[-Identity] <MailboxIdParameter>]
    [-Credential <PSCredential>]
    [-DomainController <Fqdn>]
    [-Filter <String>]
    [-GroupMailbox]
    [-IgnoreDefaultScope]
    [-OrganizationalUnit <OrganizationalUnitIdParameter>]
    [-PhotoType <String>]
    [-Preview]
    [-ReadFromDomainController]
    [-ResultSize <Unlimited>]
    [-SortBy <String>]
    [<CommonParameters>]

Описание

Примеры

Пример 1

Get-UserPhoto "Susan Burk"

Пример 2

Get-UserPhoto "Pilar Pinilla" -Preview

Параметры

-Anr

Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр Anr определяет строку, по которой будет выполнен поиск с разрешением неоднозначных имен (ANR). Можно задать частичное строковое значение и выполнить поиск объектов с атрибутом, который совпадает с этой строкой. По умолчанию искомыми атрибутами являются:

• CommonName (CN)
• DisplayName
• FirstName
• LastName
• Alias

Свойства параметров

Наборы параметров

-Credential

Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр Credential указывает имя пользователя и пароль, используемые для выполнения этой команды. Как правило, этот параметр используется в сценариях, или если требуется указывать различные учетные данные, которые предоставляют необходимые разрешения.

Для значения этого параметра требуется командлет Get-Credential. Чтобы приостановить эту команду и получить приглашение для ввода учетных данных, используйте значение (Get-Credential). Или перед выполнением этой команды сохраните учетные данные в переменной (например,$cred = Get-Credential), а затем используйте имя переменной ($cred) для этого параметра. Для получения дополнительной информации см. Get-Credential.

Свойства параметров

Наборы параметров

-DomainController

Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Свойства параметров

Наборы параметров

-Filter

Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр Filter использует синтаксис OPATH для фильтрации результатов по указанным свойствам и значениям. Для критериев поиска используется следующий синтаксис: "Property -ComparisonOperator 'Value'".

• Заключите весь фильтр OPATH в двойные кавычки " ". Если фильтр содержит системные значения (например, $true, $false или $null), используйте одиночные кавычки ' '. Хотя этот параметр является строкой (а не системным блоком), вы также можете использовать фигурные скобки { }, но только если фильтр не содержит переменные.
• Property — это свойство с поддержкой фильтрации.
• ComparisonOperator — это оператор сравнения OPATH (например -eq , для равенства и -like для строкового сравнения). Подробнее об операторах сравнения см. в статье about_Comparison_Operators.
• Value — это значение свойства для поиска. Заключите текстовые значения и переменные в одиночные кавычки ('Value' или '$Variable'). Если значение переменной содержит одиночные кавычки, необходимо определить (избежать) одиночные кавычки, чтобы правильно развернуть переменную. Например, вместо '$User' используйте '$($User -Replace "'","''")'. Не заключайте целые числа или системные значения в кавычки (например, используйте 500, $true, $false, или $null вместо них).

Вы можете объединить несколько условий поиска в цепочку с помощью логических операторов -and и -or. Например, "Criteria1 -and Criteria2" или "(Criteria1 -and Criteria2) -or Criteria3".

Подробные сведения о фильтрах OPATH в Exchange см. в статье "Дополнительные сведения о синтаксисе OPATH".

Свойства параметров

Наборы параметров

-GroupMailbox

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Переключатель GroupMailbox необходим для возврата Группы Microsoft 365 в результатах. С этим параметром не нужно указывать значение.

Свойства параметров

Наборы параметров

-Identity

Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

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

Внимание: значение $null или несуществующее значение параметра Identity возвращает все объекты так, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity точны и не содержат несуществующих значений $null.

Свойства параметров

Наборы параметров

-IgnoreDefaultScope

Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

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

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

Свойства параметров

Наборы параметров

-OrganizationalUnit

Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр OrganizationalUnit фильтрует результаты на основе расположения объекта в Active Directory. Возвращаются только те объекты, которые существуют в указанном расположении. Допустимые значения для этого параметра — подразделение или домен, которые возвращаются с помощью командлета Get-OrganizationalUnit. Вы можете использовать любое значение, уникальным образом определяющее подразделение или домен. Пример:

• Имя
• Имя
• различающееся имя (DN);
• GUID

Свойства параметров

Наборы параметров

-PhotoType

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Свойства параметров

Наборы параметров

-Preview

Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр Preview фильтрует результаты по фотографиям предварительного просмотра. С этим параметром не нужно указывать значение.

Фотография для предварительного просмотра — это фотография, которая была загружена в учетную запись пользователя, но не сохранена, например, если пользователь добавляет фотографию в параметры Outlook в Интернете, но не сохраняет ее. При использовании параметра Preview после сохранения фото пользователя этот командлет возвращает ошибку и сообщение о том, что фото предварительного просмотра не существует.

Свойства параметров

Наборы параметров

-ReadFromDomainController

Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Команда: чтобы включить все объекты в лесу, Set-AdServerSettings -ViewEntireForest $true требуется ключ ReadFromDomainController. В противном случае команда может использовать глобальный каталог, содержащий устаревшие сведения. Кроме того, для получения информации может потребоваться выполнить несколько итераций команды с помощью переключателя ReadFromDomainController.

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

Свойства параметров

Наборы параметров

-ResultSize

Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр ResultSize указывает максимальное число возвращаемых результатов. Если требуется возвратить все результаты, отвечающие условиям запроса, используйте для этого параметра значение unlimited. Значение по умолчанию — 1000.

Свойства параметров

Наборы параметров

-SortBy

Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр SortBy указывает свойство, по которому необходимо сортировать результаты. Вы можете выполнять сортировку не более, чем по одному свойству одновременно. Результаты будут отсортированы в порядке возрастания.

Если представление по умолчанию не включает свойство, по которому выполняется сортировка, к команде | Format-Table -Auto Property1,Property2,...PropertyXможно добавить . создать новое представление, содержащее все свойства, которые требуется просмотреть. В именах свойств поддерживаются подстановочные знаки (*).

Можно выполнять сортировку по свойству Id.

Свойства параметров

Наборы параметров

CommonParameters

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

Input types

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

Output types