注: 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 |
この記事は人工知能を使用して翻訳されました。疑問がある場合は、元の英語版をご確認ください。
