注: PowerShellとの連携には、ShareGate MigrateのProまたはEnterpriseサブスクリプションが必要です。Essentialsプランでは利用できません。

コマンド

Get-Team

説明

Microsoft 365テナントからチームを取得するコマンドです。

Microsoft Teams PowerShellモジュールがインストールされている場合、このモジュールにもGet-Teamコマンドが含まれているため、競合によるエラーが発生することがあります。

スクリプト内でこの問題を解決するには、プレフィックスを使用します。Import-Module行でプレフィックスを作成し、以下の例のようにgetコマンドにそのプレフィックスを追加します。

Import-Module sharegate -Prefix MY
$mypassword = ConvertTo-SecureString 'my_password' -AsPlainText -Force
$mytenant = Connect-Tenant -Domain mydomain -Username "my_username" -Password $mypassword
Get-MYTeam -Tenant $mytenant -AllowMultiple

これにより、Microsoft Teamsのバージョンではなく、ShareGateのGet-Teamコマンドが使用されます。

例

テナントの単一のチームを取得する

$tenant = Connect-Tenant -Domain mytenantdomain
Get-Team -Tenant $tenant

テナントのチームを取得する

$tenant = Connect-Tenant -Domain mytenantdomain
Get-Team -Tenant $tenant -AllowMultiple

名前でチームを取得する

$tenant = Connect-Tenant -Domain mytenantdomain
Get-Team -Name "MyTeam" -Tenant $tenant

同じ名前のすべてのチームを取得する

$tenant = Connect-Tenant -Domain mytenantdomain
Get-Team -Name "MyTeam" -Tenant $tenant -AllowMultiple

名前で複数のチームを取得する

$tenant = Connect-Tenant -Domain mytenantdomain
Get-Team -Name "FirstTeam", "SecondTeam" -Tenant $tenant

ワイルドカードを使用して名前で複数のチームを取得する

$tenant = Connect-Tenant -Domain mytenantdomain
Get-Team -Name "*Team" -Tenant $tenant -AllowMultiple

注: *記号は、類似した名前の複数のオブジェクトを呼び出すために使用されます。

IDでチームを取得する

$tenant = Connect-Tenant -Domain mytenantdomain
Get-Team -Id "12345678-1234-1234-1234-123456789012" -Tenant $tenant

IDで複数のチームを取得する

$tenant = Connect-Tenant -Domain mytenantdomain
Get-Team -Id "11111111-1234-1234-1234-123456789012", "22222222-1234-1234-1234-123456789012" -Tenant $tenant

構文

Get-Team
-Tenant <Tenant>
[-AllowMultiple <SwitchParameter>]

Get-Team
-Name <String[]>
-Tenant <Tenant>
[-AllowMultiple <SwitchParameter>]

Get-Team
-Id <Guid[]>
-Tenant <Tenant>
[-AllowMultiple <SwitchParameter>]

パラメーター

-AllowMultiple <SwitchParameter>

コマンドが複数のチームを返せることを指定します。

必須かどうか	False
既定値	None
パイプライン入力を許可するか	False
ワイルドカード文字を許可するか	False
パラメーターセット名	(All)
エイリアス	None

-Id <Guid[]>

チームのIDを指定します。

必須かどうか	True
既定値	None
パイプライン入力を許可するか	False
ワイルドカード文字を許可するか	False
パラメーターセット名	Id
エイリアス	None

-Name <String[]>

チームの名前を指定します。

必須かどうか	True
既定値	None
パイプライン入力を許可するか	False
ワイルドカード文字を許可するか	True
パラメーターセット名	Name
エイリアス	None

-Tenant <Tenant>

SharePoint管理センターサイトを指定します。

必須かどうか	True
既定値	None
パイプライン入力を許可するか	true (ByValue)
ワイルドカード文字を許可するか	False
パラメーターセット名	(All)
エイリアス	None

この記事はAIによって翻訳されています。ご不明な点がある場合は、英語の原文をご確認ください。

Get Team