Share via

Get-MsolContact

  • 參考
模組:
MSOnline

從 Azure Active Directory 取得連絡人。

Syntax

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 參數。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-HasErrorsOnly

指出此 Cmdlet 會傳回有驗證錯誤的連絡人。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxResults

指定這個 Cmdlet 傳回的結果數目上限。 預設值為 500。

Type:Int32
Position:Named
Default value:500
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

指定要取得之連絡人的唯一物件識別碼。

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SearchString

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TenantId

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

輸出

Microsoft.Online.Administration.Contact

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

  • City： 連絡人的城市。

  • 國家。 連絡人的國家/地區。

  • 部門。 連絡人的部門。

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

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

  • FirstName。 連絡人的名字。

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

  • LastName 連絡人的姓氏。

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

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

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

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

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

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

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

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

  • 標題。 連絡人職稱。

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

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