通过

Get-UserPhoto

模块:
Exchange PowerShell

此 cmdlet 仅适用于本地 Exchange。

使用 Get-UserPhoto cmdlet 查看有关用户照片功能的信息，该功能允许用户将图片与其帐户相关联。 用户照片显示在客户端应用程序（如 Outlook、Microsoft Teams 和 SharePoint）中。

注意：在 Microsoft 365 中，可以在 Microsoft Graph PowerShell 中管理用户照片。 有关说明，请参阅 在 Microsoft Graph PowerShell 中管理用户照片。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

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>]

说明

用户照片功能使用户可以将图片与其帐户关联。 用户照片存储在用户的 Active Directory 帐户和用户的 Exchange 邮箱的根目录中。 必须先为用户设置用户照片功能，然后才能运行 Get-UserPhoto cmdlet 来查看有关用户照片的信息。 否则，你会收到一条错误消息，指出指定用户不存在用户照片。 管理员使用 Set-UserPhoto cmdlet 或 Exchange 管理中心 (EAC) 来配置用户照片。 用户可以使用“Outlook 网页版选项”页面上传、预览用户照片并将其保存到其帐户。

您必须先获得权限，然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数，但如果某些参数未包含在分配给你的权限中，则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Get-UserPhoto "Susan Burk"

此示例显示有关为 Susan Burk 配置的用户照片的信息。

示例 2

Get-UserPhoto "Pilar Pinilla" -Preview

此示例显示已上传到 Pilar Pinilla 帐户但未保存的用户照片的相关信息。

参数

-Anr

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Anr 参数指定字符串，用于执行模糊名称解析 (ANR) 搜索。 可以指定部分字符串，并搜索其属性与该字符串匹配的对象。 搜索的默认属性是：

  • CommonName (CN)
  • DisplayName
  • FirstName
  • LastName
  • 别名

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

AnrSet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Credential

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Credential 参数指定用于运行此命令的用户名和密码。 通常情况下，您可以在脚本中或在需要提供具有所需权限的不同凭据时使用此参数。

此参数的值需要 Get-Credential cmdlet。 要暂停此命令并接收凭据提示，请使用值 (Get-Credential)。 或者，在运行此命令之前，请将凭据存储在变量（例如，$cred = Get-Credential）中，然后将变量名称 ($cred) 用作此参数。 有关详细信息，请参阅 Get-Credential。

参数属性

类型:PSCredential
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DomainController

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。

参数属性

类型:Fqdn
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Filter

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Filter 参数使用 OPATH 语法按指定的属性和值筛选结果。 搜索条件使用 语法 "Property -ComparisonOperator 'Value'"。

  • 将整个 OPATH 筛选器括在双引号“”中。 如果筛选器包含系统值 (，例如 $true、 $false或 $null) ，请改用单引号 ' 。 虽然此参数是 (不是系统块) 的字符串，但也可以使用大括号 { }，但前提是筛选器不包含变量。
  • 属性是可筛选的属性。
  • ComparisonOperator 是一个 OPATH 比较运算符， (例如 -eq 用于等于和 -like 字符串比较) 。 有关比较运算符的详细信息，请参阅 about_Comparison_Operators。
  • Value 是要搜索的属性值。 将文本值和变量括在单引号 ('Value' 或 '$Variable') 。 如果变量值包含单引号，则需要识别 (转义) 单引号才能正确展开变量。 例如，使用 '$($User -Replace "'","''")'而不是 '$User'。 不要将整数或系统值括在引号 (例如，改用 500、 $true、 $false或 $null) 。

可以使用逻辑运算符 -and 和 -or将多个搜索条件链接在一起。 例如，"Criteria1 -and Criteria2" 或 "(Criteria1 -and Criteria2) -or Criteria3"。

有关 Exchange 中的 OPATH 筛选器的详细信息，请参阅 其他 OPATH 语法信息。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-GroupMailbox

适用：2016 Exchange Server、Exchange Server 2019

需要 GroupMailbox 开关才能返回结果中的Microsoft 365 组。 不必为此开关指定值。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Identity

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Identity 参数指定用户帐户。 可以使用唯一标识用户帐户的任何值。 例如：

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 域\用户名
  • 电子邮件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 用户 ID 或用户主体名称 (UPN)

参数属性

类型:MailboxIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

Identity
Position:1
必需:False
来自管道的值:True
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-IgnoreDefaultScope

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

IgnoreDefaultScope 开关指示命令忽略 Exchange PowerShell 会话的默认收件人范围设置，并将整个林用作范围。 不必为此开关指定值。

此开关使命令能够访问当前在默认范围中不可用的 Active Directory 对象，但也引入了以下限制：

  • 无法使用 DomainController 参数。 此命令自动使用相应的全局编录服务器。
  • 无法使用 DomainController 参数。 此命令自动使用相应的全局编录服务器。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-OrganizationalUnit

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

OrganizationUnit 参数根据对象在 Active Directory 中的位置筛选结果。 只返回存在于指定位置的对象。 此参数的有效输入是由 Get-OrganizationalUnit cmdlet 返回的组织单位 (OU) 或域。 可以使用任何能够唯一标识此 OU 或域的值。 例如：

  • 名称
  • 名称
  • 可分辨名称 (DN)
  • GUID

参数属性

类型:OrganizationalUnitIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-PhotoType

适用：2016 Exchange Server、Exchange Server 2019

保留此参数以供 Microsoft 内部使用。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Preview

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

预览开关按预览照片筛选结果。 不必为此开关指定值。

预览照片是已上传到用户帐户但未保存的照片，例如，如果用户在“Outlook 网页版选项”中上传了照片，但未保存该照片。 如果在保存用户照片后使用预览开关，此 cmdlet 将返回一个错误，指出预览照片不存在。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ReadFromDomainController

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

ReadFromDomainController 开关指定从用户域中的域控制器读取的信息。 不必为此开关指定值。

命令： Set-AdServerSettings -ViewEntireForest $true 若要包含林中的所有对象，需要 ReadFromDomainController 开关。 否则，命令可能会使用包含过时信息的全局编录。 此外，可能需要使用 ReadFromDomainController 开关运行命令的多个迭代才能获取信息。

默认情况下，收件人范围设置为托管 Exchange 服务器的域。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ResultSize

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

ResultSize 参数指定了要返回的结果的最大数量。 若要返回所有与查询相匹配的请求，则请将此参数的值设为无限制。 默认值为 1000。

参数属性

类型:Unlimited
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-SortBy

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

SortBy 参数指定用作结果排序依据的属性。 每次只能按一个属性进行排序。 结果将按升序进行排序。

如果默认视图不包括要排序依据的属性，则可以使用 | Format-Table -Auto Property1,Property2,...PropertyX追加命令。 创建包含要查看的所有属性的新视图。 支持在属性名称中使用通配符 (*)。

可以按 Id 属性排序。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

输入

Input types

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。