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

説明

Set-EntraUserThumbnailPhoto コマンドレットは、ユーザーのサムネイル写真を設定するために使用されます。

組織内のユーザーの写真を更新するには、 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
DontShow:False

パラメーター セット

File
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-UserId

ユーザーのサムネイル写真が設定されているユーザーのオブジェクト ID。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:オブジェクト識別子, UPN, アイデンティティ, ユーザープリンシパルネーム

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

System.String

System.IO.Stream System.Byte[]

出力

System.Object