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

Description

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

指定要取得之聯繫人的唯一對象識別碼。

類型:	Guid
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-SearchString

指定字串。 此 Cmdlet 會傳回以這個字串開頭的顯示名稱或電子郵件地址的聯繫人。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TenantId

指定要在其中執行作業之租使用者的唯一標識符。 預設值為目前使用者的租使用者。 此參數僅適用於合作夥伴使用者。

類型:	Guid
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

輸出

Microsoft.Online.Administration.Contact

此 Cmdlet 會傳回聯繫人物件，其中包含下列資訊：

• City： 連絡人的城市。

• 國家。 聯繫人的國家/地區。

• 部門。 連絡人的部門。

• DisplayName。 連絡人的顯示名稱。

• 傳真。 連絡人的傳真號碼。

• FirstName。 連絡人的名字。

• LastDirSyncTime。 傳回上次同步的日期和時間 (只有使用 Active Directory 同步處理進行同步的連絡人會傳回)。

• LastName 連絡人的姓氏。

• 手機。 連絡人的行動電話號碼。

• ObjectId。 連絡人的唯一識別碼。

• 辦公室。 連絡人的辦公室電話號碼。

• 電話號碼。 連絡人的電話號碼。

• 郵遞區號。 連絡人的郵遞區號。

• Proxy 位址。 與此聯繫人相關聯的 Proxy 位址。

• 狀態。 連絡人的州 (省)。

• StreetAddress。 連絡人的街道地址。

• 標題。 連絡人職稱。

• UserPrincipalName。 連絡人的使用者識別碼。

• ValidationStatus。 連絡人是否有任何錯誤。

相關連結

• Remove-MsolContact