Set-EntraUserThumbnailPhoto

模組:
Microsoft.Entra.Users Module v1.3

為使用者設定縮圖照片。

語法

File (預設值) 

Set-EntraUserThumbnailPhoto

    -UserId <String>
    -FilePath <String>
    [<CommonParameters>]

Stream 

Set-EntraUserThumbnailPhoto

    -FileStream <Stream>
    -UserId <String>
    [<CommonParameters>]

ByteArray 

Set-EntraUserThumbnailPhoto

    -UserId <String>
    -ImageByteArray <Byte[]>
    [<CommonParameters>]

Description

Set-EntraUserThumbnailPhoto這個 cmdlet 用來設定使用者的縮圖照片。

更新組織中任何用戶的照片都需要取得 User.ReadWrite.All 授權。 僅更新已登入用戶的照片需要取得 User.ReadWrite 授權。

範例

範例 1：設定縮圖照片

Connect-Entra -Scopes 'User.ReadWrite', 'User.ReadWrite.All'
Set-EntraUserThumbnailPhoto -UserId 'SawyerM@contoso.com' -FilePath 'D:\UserThumbnailPhoto.jpg'

此範例將以 UserID 參數指定的使用者縮圖照片，轉換為以 FilePath 參數指定的影像。

  • -UserId參數指定 Microsoft Entra ID 中使用者的 ID。
  • -FilePath 參數指定要上傳的影像檔案路徑，作為使用者縮圖照片。

參數

-FilePath

要上傳的圖片檔案路徑，作為使用者縮圖照片。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

File
Position:Named
必要:True
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-UserId

使用者縮圖照片所設定的使用者的物件 ID。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False
別名:ObjectId (物件識別碼), UPN, Identity, 使用者主要名稱 (UserPrincipalName)

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

System.String

System.IO.Stream System.Byte[]

輸出

System.Object