共用方式為

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。 連絡人是否有任何錯誤。