Microsoft Teams PowerShell を使用して Teams を管理する
この記事では、Microsoft Teams PowerShell を使用して Teams とSkype for Businessを管理する方法について説明します。
このガイダンスは、Microsoft Teams コマンドレットリファレンスとSkype for Businessコマンドレットリファレンスと組み合わせて使用します。
Teams 管理センターで Teams を管理するには、「Azure Cloud Shellを使用した Teams の管理」を参照してください。
PowerShell を使用してチームを作成および管理する
チームを作成し管理するためのコマンドレットは、Microsoft Teams PowerShell モジュールにあります。
Teams はOffice 365 グループによってサポートされるため、チームを作成するときはグループを作成します。 コア チームとその設定 (、チーム ユーザーadd-teamuser
の管理 (new-team
、get-team
) を管理するために提供されるコマンドレットのセットと、remove-teamuser
チームのチャネルを管理するためのコマンドレット (new-teamchannel
, remove-teamchannel
) があります。 set-team
これらのコマンドレットはすべてエンド ユーザーとして実行できますが、自分が所有している、またはメンバーであるチームのみが機能します。 グローバル 管理または Teams 管理者の場合は、組織内のすべてのチームを操作できます。
New-Team -DisplayName "Contoso Marketing" -Description "Collaboration space for Contoso's Marketing department"
注意
Microsoft Teams PowerShell モジュールのコマンドレットで使用されている GroupId は、Exchange PowerShell モジュールで Get-UnifiedGroup
により返された Identity プロパティと同じです。
Azure Cloud Shellを使用して Teams を管理する
Cloud Shellは、リソースを管理できる、対話型で認証されたブラウザーからアクセス可能なシェルです。 Cloud Shellの詳細については、「Azure Cloud Shell」を参照してください。
Azure Cloud Shellにアクセスし、PowerShell を使用して Teams を管理するには、Teams 管理センターにサインインします。
右上隅にあるCloud Shell アイコンを選択します。
メッセージが表示されたら、 PowerShell を選択します。
Teams PowerShell セッションを開始するには、次のコマンドを実行します。
Connect-MicrosoftTeams
これらの手順を完了したら、Teams PowerShell コマンドを実行する準備が整いました。
大事な
Cs* コマンドレットを使用する場合は、最初にコマンドを使用して Teams に接続する Connect-MicrosoftTeams -UseDeviceAuthentication
必要があります。
PowerShell を使用してポリシーを管理する
注意
- オンライン コネクタSkype for Business Teams PowerShell に統合されます。 Teams に適用されるSkype for Business Online コマンドレットは、Teams PowerShell モジュールでネイティブに使用できます。 インストール手順については、 Teams PowerShell のインストールに関する 記事を参照してください。
- Teams に接続すると、PowerShell セッションでコマンドレットを使用できるようになります。 詳細については、「Office 365 PowerShell を使用して Skype for Business Online を管理する」を参照してください。
Skype for Business コマンドレット モジュールでポリシーを管理するためのコマンドレットを見つけます。
ポリシーは、個々のユーザーに細かく適用できる設定のまとまりです。 各ポリシーの種類にはポリシーそのものの作成、表示、削除、更新を行い、これらのポリシーをユーザーに割り当てるための独自のコマンドレットのセットがあります。 一般的な構成は次のとおりです。
GET コマンド (たとえば):
Get-CsTeamsMeetingPolicy
組織で割り当て可能なポリシー ドキュメントを返します。これには、Microsoft が使用するために作成したポリシーや、作成したカスタム ポリシーが含まれます。- 組織内で作成したカスタム ポリシーのみを検索するには、
-Filter "tag:*"
.
- 組織内で作成したカスタム ポリシーのみを検索するには、
NEW コマンド (たとえば):
New-CsTeamsMeetingPolicy
組織内のユーザーに割り当てる組織の新しいポリシーを作成します。 すべてのポリシーがカスタム ポリシーの作成をサポートするわけではありません。 多くの場合、組織で使用するポリシーに、サポート対象の設定の組み合わせがあることを確認するためです。SET コマンド (たとえば):
Set-CsTeamsMeetingPolicy
特定のポリシーの特定の値を設定します。 一部のポリシーには SET コマンドが使用できないか、ポリシーでカスタマイズできないパラメーターが含まれています。 PowerShell の説明では、カスタマイズできないパラメーターが示されています。- カスタム ポリシーが割り当てられていない組織内のユーザーに既定で割り当てられるポリシーを編集するには、
Set-Cs<PolicyName> -Identity Global
を実行します。
- カスタム ポリシーが割り当てられていない組織内のユーザーに既定で割り当てられるポリシーを編集するには、
REMOVE コマンド (たとえば):
Remove-CsTeamsMeetingPolicy
テナントに作成されたカスタム ポリシーを削除します。 組織内の少なくとも 1 人のユーザーに割り当てられているカスタム ポリシーを削除した場合、そのユーザーはグローバル ポリシーに戻ります。- 実際に組織内のグローバル ポリシーを削除することはできませんが、組織内のグローバル ポリシーを Microsoft が提供する既定の設定にリセットする場合は、実行
Remove-Cs<PolicyName> -Identity Global
します。
- 実際に組織内のグローバル ポリシーを削除することはできませんが、組織内のグローバル ポリシーを Microsoft が提供する既定の設定にリセットする場合は、実行
GRANT コマンド (たとえば):
Grant-CsTeamsMeetingPolicy
特定のユーザーにポリシーを割り当てます。- カスタム ポリシーの割り当てを削除し、組織の既定のポリシーにユーザーを戻すには、
Grant-Cs<PolicyName> -Identity <User Identity> -PolicyName $null
を実行します。
- カスタム ポリシーの割り当てを削除し、組織の既定のポリシーにユーザーを戻すには、
ヒント
すべてのポリシーでカスタム ポリシーの作成が許可されているわけではなく、一部のポリシーにはカスタマイズできない設定が含まれています (そのため、設定は表示できますが、set-
とnew-
の間にカスタム値を設定できません)。 各コマンドレットのドキュメントでは、お客様がパラメーターを使用できるかどうかを示しています。
共通パラメーター:
- Identity:
Get-
、Set-
、New-
、Remove-
の場合、Identity パラメーターは常に特定のポリシー インスタンスを参照します。Grant
の場合、Identity パラメーターは、ポリシーが適用されている特定のユーザー オブジェクトを参照します。
PowerShell を使用して構成を管理する
Skype for Business コマンドレット モジュールで、構成を管理するためのコマンドレットを見つけます。
構成は、ユーザー レベルでは指定できない、サービスで管理される設定のバケットです。 設定は常に組織全体に適用されます。 グローバル構成は、組織で唯一の有効な構成です。 各構成の種類には、次の 2 つの主なコマンドレットが用意されています。
Get-Cs<ConfigurationName>
(例:Get-CsTeamsClientConfiguration
):SET コマンド (例:
Set-CsTeamsClientConfiguration
): その種類の構成でプロパティを設定します。 変更するパラメーターを指定します。注意
Identity Global の指定、または
Get-Cs<ConfigurationName>
|Set-Cs<ConfigurationName>
の実行のいずれかの方法で変更を行っている構成を参照できます。
管理者の役割がそれぞれできること
Microsoft Teams 管理者ロールを使用して Teams を管理し、各 PowerShell コマンドレットを実行できる管理者ロールを理解する方法について説明します。