メインコンテンツにスキップ

Get-ChatUser

PowerShell でチャット移行に使用できる Microsoft Teams ユーザーを取得する

注: PowerShell 統合には、ShareGate の Migration Pro または Migration Ultimate パッケージが必要です。Migration Essentials Mailbox または Migration Essentials Files パッケージでは利用できません。

コマンド

Get-ChatUser

説明

Get-ChatUser は、チャット移行に使用できる Microsoft Teams ユーザーを取得します。特定のユーザーを検索するには -Id、-Name、-EmailAddress を使用します。いずれも指定せずにコマンドを実行すると、使用できるすべてのユーザーが一覧表示されます。

例

ID でチャット ユーザーを取得する

$connection = Connect-MicrosoftOnline -CopyFeature ChatCopy
$userId = "0bc4c795-fc91-4920-b3dd-bb33c4e2e6cd"
Get-ChatUser -Id $userId -Connection $connection

ID で複数のチャット ユーザーを取得する

$connection = Connect-MicrosoftOnline -CopyFeature ChatCopy
$userIds = "0bc4c795-fc91-4920-b3dd-bb33c4e2e6cd", "4b54a732-7259-44bd-aaac-2dca7a5335d0"
Get-ChatUser -Id $userIds -Connection $connection -AllowMultiple

名前でチャット ユーザーを取得する

$connection = Connect-MicrosoftOnline -CopyFeature ChatCopy
Get-ChatUser -Name "Adele Vance" -Connection $connection

名前で複数のチャット ユーザーを取得する

$connection = Connect-MicrosoftOnline -CopyFeature ChatCopy
$userNames = "Adele Vance", "Alex Wilber"
Get-ChatUser -Name $userNames -Connection $connection -AllowMultiple

メール アドレスでチャット ユーザーを取得する

$connection = Connect-MicrosoftOnline -CopyFeature ChatCopy
Get-ChatUser -EmailAddress "[email protected]" -Connection $connection

メール アドレスで複数のチャット ユーザーを取得する

$connection = Connect-MicrosoftOnline -CopyFeature ChatCopy
$userEmails = "[email protected]", "[email protected]"
Get-ChatUser -EmailAddress $userEmails -Connection $connection -AllowMultiple

すべてのチャット ユーザーを取得する

$connection = Connect-MicrosoftOnline -CopyFeature ChatCopy
Get-ChatUser -Connection $connection -AllowMultiple

構文

Get-ChatUser
-Connection <IConnection>
[-AllowMultiple]
Get-ChatUser
-Name <String[]>
-Connection <IConnection>
[-AllowMultiple]
Get-ChatUser
-Id <String[]>
-Connection <IConnection>
[-AllowMultiple]
Get-ChatUser
-EmailAddress <String[]>
-Connection <IConnection>
[-AllowMultiple]

パラメーター

-AllowMultiple <SwitchParameter>

コマンドが複数のチャット ユーザーを返せるように指定します。

必須

False

既定値

None

パイプライン入力を受け入れる

False

ワイルドカード文字を受け入れる

False

パラメーター セット名

(All)

エイリアス

None

-Connection <IConnection>

ソース テナントの接続を指定します。

必須

True

既定値

None

パイプライン入力を受け入れる

True (ByValue)

ワイルドカード文字を受け入れる

False

パラメーター セット名

(All)

エイリアス

None

-EmailAddress <String[]>

チャット ユーザーのメール アドレスを指定します (ワイルドカードを使用できます)。複数の値を指定するには、それぞれを引用符で囲んだ文字列として、コンマで区切って渡します。コンマ区切りの 1 つの文字列は、1 つの値として読み取られます。

必須

True

既定値

System.String[]

パイプライン入力を受け入れる

False

ワイルドカード文字を受け入れる

True

パラメーター セット名

EmailAddress

エイリアス

None

-Id <String[]>

チャット ユーザーの ID を指定します。

必須

True

既定値

System.String[]

パイプライン入力を受け入れる

False

ワイルドカード文字を受け入れる

False

パラメーター セット名

Id

エイリアス

None

-Name <String[]>

チャット ユーザーの表示名を指定します (ワイルドカードを使用できます)。複数の値を指定するには、それぞれを引用符で囲んだ文字列として、コンマで区切って渡します。コンマ区切りの 1 つの文字列は、1 つの値として読み取られます。

必須

True

既定値

System.String[]

パイプライン入力を受け入れる

False

ワイルドカード文字を受け入れる

True

パラメーター セット名

Name

エイリアス

None

この記事は人工知能を使用して翻訳されました。疑問がある場合は、元の英語版をご確認ください。

こちらの回答で解決しましたか?