你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Get-MsolContact

模块:

MSOnline

从 Azure Active Directory 获取联系人。

语法

Get-MsolContact
   [-HasErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]

Get-MsolContact
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]

Get-MsolContact
   [-HasErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

说明

Get-MsolContact cmdlet 获取联系人对象或联系人列表。 指定 ObjectId 参数以获取单个联系人。

示例

示例 1：获取联系人

PS C:\> Get-MsolContact -ObjectId adc41dc7-4130-4215-adfb-2403bc9f844e

此命令检索联系人。

示例 2：获取与字符串匹配的联系人

PS C:\> Get-MsolContact -SearchString "Patti"

此命令检索具有以 Patti 开头的显示名称或电子邮件地址的联系人列表。

参数

-All

指示此 cmdlet 返回它找到的所有结果。 不要指定此参数和 MaxResults 参数。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-HasErrorsOnly

指示此 cmdlet 返回具有验证错误的联系人。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MaxResults

指定此 cmdlet 返回的最大结果数。 默认值为 500。

类型:	Int32
Position:	Named
默认值:	500
必需:	False
接受管道输入:	False
接受通配符:	False

-ObjectId

指定要获取的联系人的唯一对象 ID。

类型:	Guid
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-SearchString

指定字符串。 此 cmdlet 返回显示名称或电子邮件地址以此字符串开头的联系人。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TenantId

指定要对其执行操作的租户的唯一 ID。 默认值为当前用户的租户。 此参数仅适用于合作伙伴用户。

类型:	Guid
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

输出

Microsoft.Online.Administration.Contact

此 cmdlet 返回联系人对象，其中包括以下信息：

• 市县： 联系人所在的城市。

• 国家或地区。 联系人的国家或地区。

• 部门。 联系人所在的部门。

• DisplayName。 联系人的显示名称。

• 传真。 联系人的传真号码。

• FirstName。 联系人的名字。

• LastDirSyncTime。 返回上次同步的日期和时间（只从已使用 Active Directory 同步进行同步的联系人返回）。

• LastName 联系人的姓氏。

• 手机。 联系人的移动电话号码。

• ObjectId。 联系人的唯一 ID。

• 办公室。 联系人的办公电话号码。

• 电话号码。 联系人的电话号码。

• 邮政编码。 联系人的邮政编码。

• 代理地址。 与此联系人关联的代理地址。

• State。 联系人所在的省/市/自治区。

• StreetAddress。 联系人的街道地址。

• 标题。 联系人的头衔。

• UserPrincipalName。 联系人的用户 ID。

• ValidationStatus。 联系人是否出现任何错误。

相关链接

• Remove-MsolContact