Set-UserPhoto

構文

CancelPhoto

Set-UserPhoto
    [-Identity] <MailboxIdParameter>
    [-Cancel]
    [-Confirm]
    [-GroupMailbox]
    [-DomainController <Fqdn>]
    [-IgnoreDefaultScope]
    [-PhotoType <String>]
    [-UseCustomRouting]
    [-WhatIf]
    [<CommonParameters>]

UploadPhotoData

Set-UserPhoto
    [-Identity] <MailboxIdParameter>
    -PictureData <Byte[]>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-GroupMailbox]
    [-IgnoreDefaultScope]
    [-PhotoType <String>]
    [-UseCustomRouting]
    [-WhatIf]
    [<CommonParameters>]

UploadPreview

Set-UserPhoto
    [-Identity] <MailboxIdParameter>
    [-PictureData <Byte[]>]
    [-PictureStream <Stream>]
    [-Preview]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-GroupMailbox]
    [-IgnoreDefaultScope]
    [-PhotoType <String>]
    [-UseCustomRouting]
    [-WhatIf]
    [<CommonParameters>]

UploadPhotoStream

Set-UserPhoto
    [-Identity] <MailboxIdParameter>
    -PictureStream <Stream>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-GroupMailbox]
    [-IgnoreDefaultScope]
    [-PhotoType <String>]
    [-UseCustomRouting]
    [-WhatIf]
    [<CommonParameters>]

SavePhoto

Set-UserPhoto
    [-Identity] <MailboxIdParameter>
    [-Save]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-GroupMailbox]
    [-IgnoreDefaultScope]
    [-PhotoType <String>]
    [-UseCustomRouting]
    [-WhatIf]
    [<CommonParameters>]

説明

例

例 1

Set-UserPhoto -Identity "Paul Cannon" -PictureData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\PaulCannon.jpg"))

例 2

Set-UserPhoto -Identity "Ann Beebe" -PictureData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\AnnBeebe.jpg")) -Preview

Set-UserPhoto "Ann Beebe" -Save

例 3

Set-UserPhoto -Identity "Ann Beebe" -Cancel

パラメーター

-Cancel

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

[キャンセル] スイッチを押すと、現在のプレビュー写真が削除されます。 このスイッチで値を指定する必要はありません。

ユーザーのアカウントに現在関連付けられている写真を削除するには、Remove-UserPhoto コマンドレットを使用します。 Cancel スイッチはプレビュー写真のみを削除します。

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

パラメーター セット

-Confirm

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットに与える影響は、コマンドレットが続行する前に確認を必要とするかどうかによって異なります。

• データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
• 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値を指定せずに Confirm スイッチを指定すると、一時停止が発生し、続行する前にコマンドの確認を強制されます。

このコマンドレットには一時停止が組み込まれているため、 -Confirm:$false を使用して確認をスキップします。

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

パラメーター セット

-DomainController

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。

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

パラメーター セット

-GroupMailbox

適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE

GroupMailbox スイッチは、Microsoft 365 グループを変更するために必要です。 このスイッチで値を指定する必要はありません。

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

パラメーター セット

-Identity

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Identity パラメーターは、ユーザーの ID を指定します。 ユーザーを一意に識別する任意の値を使用できます。 以下に例を示します。

• 名前
• Alias
• 識別名 (DN)
• 正規 DN
• ドメイン\ユーザー名
• 電子メール アドレス
• GUID
• LegacyExchangeDN
• SamAccountName
• ユーザー ID またはユーザー プリンシパル名 (UPN)

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

パラメーター セット

-IgnoreDefaultScope

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

IgnoreDefaultScope スイッチは、Exchange PowerShell セッションに対する受信者の範囲の既定の設定を無視し、フォレスト全体を範囲として使用するようにコマンドに指示します。 このスイッチで値を指定する必要はありません。

このスイッチを使用すると、コマンドは、既定の範囲では現在使用できない Active Directory オブジェクトにアクセスできますが、次の制限もあります。

• DomainController パラメーターは使用できません。 このコマンドは、適切なグローバル カタログ サーバーを自動的に使用します。
• Identity パラメーターの DN しか使用できません。 エイリアスや GUID などの他の形式の ID は使用できません。

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

パラメーター セット

-PhotoType

適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE

このパラメーターは、Microsoft の内部使用のために予約されています。

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

パラメーター セット

-PictureData

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

PictureData パラメーターは、ユーザーのアカウントにアップロードする写真ファイルを指定します。

このパラメーターの有効な値を指定するには、次の構文を使用してファイルをバイト エンコード オブジェクトに読み取る必要があります。 ([System.IO.File]::ReadAllBytes('<Path>\<FileName>'))。 このコマンドはパラメーター値として使用することも、出力を変数 ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) に書き込み、変数をパラメーター値 ($data) として使用することもできます。

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

パラメーター セット

-PictureStream

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

PictureStream パラメーターは、ユーザーのアカウントにアップロードする写真を指定します。 このパラメーターは、ユーザーが写真を追加するときに、Outlook on the web などのクライアント アプリケーションによって使用されます。 PowerShell を使用して写真をアップロードするには、PictureData パラメーターを使用して写真ファイルを指定します。

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

パラメーター セット

-Preview

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Preview スイッチは、ユーザー アカウント用にプレビュー写真をアップロードします。 このスイッチで値を指定する必要はありません。

プレビューの写真はユーザーのアカウントにアップロードされますが、保存されません。 たとえば、ユーザーが Outlook on the web に写真をアップロードした場合 保存する前にプレビューするオプション。 プレビュー スイッチを使用してプレビュー写真をアップロードする場合は、コマンド Set-UserPhoto -Save を実行してユーザーの写真として保存する必要があります。

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

パラメーター セット

-Save

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

[保存] スイッチは、アップロードされた写真をユーザーの写真として保存することを指定します。 このスイッチで値を指定する必要はありません。

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

パラメーター セット

-WhatIf

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

[WhatIf] スイッチは、何も変更を加えずにコマンドが実行する内容を表示します。 このスイッチで値を指定する必要はありません。

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

パラメーター セット

CommonParameters

入力

Input types

出力

Output types