Teams での PowerShell の概要Teams PowerShell Overview

Microsoft Teams には、IT 管理者が Microsoft Teams 管理センター、PowerShell コントロール、Graph Api を通じて製品を管理するための豊富なツールセットが用意されています。Microsoft Teams has a rich set of tools for IT admins to manage the product through the Microsoft Teams admin center, PowerShell controls, and Graph APIs. このガイドでは、IT 管理者が使用する PowerShell コマンドレットの構造について説明し、さらに多くのドキュメントへのポインターを提供します。This guide explains how we structure our PowerShell cmdlets for IT admins to use, and provides pointers to further documentation. チームの管理者の役割によって、異なるコマンドレットにアクセスできることに注意してください。Note that different Teams admin roles have access to different cmdlets. 詳細については、「 Microsoft teams の管理者ロールを使用してチームを管理する」を参照してください。For more information, see Use Microsoft Teams admin roles to manage Teams.

どのモジュールを使用する必要がありますか?Which modules do you need to use?

チームを管理するための PowerShell コントロールは、次の2つの異なる PowerShell モジュールに含まれています。The PowerShell controls for managing Teams are in two different PowerShell modules:

PowerShell コントロールのリファレンスドキュメントでは、調査中のコマンドレットが含まれているモジュールを確認できます。The reference documentation for the PowerShell controls will tell you which module contains the cmdlet you're investigating. (最終的に、2つのモジュールが結合されます)。(Eventually, the two modules will be combined.)

各管理者ロールでできることWhat can each admin role do?

Microsoft Teams の管理者ロールを使用してチームを管理する」を参照し、管理者ロールによって利用できる PowerShell コマンドレットについて理解してください。Read Use Microsoft Teams admin roles to manage Teams to understand which PowerShell cmdlets different admin roles will be able to leverage.

PowerShell を使用した teams の作成と管理Creating and managing teams via PowerShell

チームを作成して管理するためのコマンドレットは、 Microsoft Teams PowerShell モジュールに含まれています。The cmdlets for creating and managing teams are in the Microsoft Teams PowerShell module.

Teams は O365 グループによってサポートされているため、チームを作成するときにグループを作成します。Teams are backed by O365 Groups, so when you create a team, you create a group. コアチームとその設定new-team(、 get-team set-team)、チームユーザーadd-teamuserの管理 (、 remove-teamuser)、およびチームnew-teamchannel remove-teamchannelのチャネルを管理するコマンドレットを操作するための一連のコマンドレットが用意されています。There are a set of cmdlets provided for operating on the core team and its settings (new-team, get-team, set-team), managing team users (add-teamuser, remove-teamuser), as well as cmdlets for managing the channels of the team (new-teamchannel, remove-teamchannel). これらのコマンドレットはすべてエンドユーザーとして実行できますが、自分が所有している、またはメンバーであるチームでのみ機能します。All of these cmdlets can be run as end users, but they'll work only on the teams that you own or are a member of. グローバル管理者または Teams のサービス管理者である場合は、組織内のすべてのチームに対して行動することができます。If you are a Global Admin or Teams Service Administrator, you'll be able to act on all teams in your organization.

Microsoft Teams PowerShell モジュールのコマンドレットで使用されるGroupIdは、Exchange **** PowerShell モジュールGet-UnifiedGroupで返される Identity プロパティと同じです。The GroupId used in the Microsoft Teams PowerShell module cmdlets is the same as the Identity property returned by Get-UnifiedGroup in the Exchange PowerShell module.

プレビューと通常利用可能な Microsoft Teams PowerShell モジュールの違いDifferences between Preview and Generally Available Microsoft Teams PowerShell Module

PowerShell モジュールの一般的なバージョンをリリースすると、次の表で説明するように、ベータ版のモジュールにいくつかのコマンドレットが残されました。When we released our generally available version of our PowerShell module, a few cmdlets were left in the beta-only module as described in the table below.

コマンドレットCmdlet プレビューで利用可能Available in Preview 1.0 で利用可能Available in 1.0
チームの追加ユーザーAdd-TeamUser はいYes はいYes
Connect-Microsoft TeamsConnect-MicrosoftTeams はいYes はいYes
切断-Microsoft TeamsDisconnect-MicrosoftTeams はいYes はいYes
チームの取得Get-Team はいYes はいYes
チームの取得チャネルGet-TeamChannel はいYes はいYes
Get-TeamFunSettingsGet-TeamFunSettings 1.0 より前のリリースのみPrior to 1.0 release only いいえNo
チームのゲスト設定を取得するGet-TeamGuestSettings 1.0 より前のリリースのみPrior to 1.0 release only いいえNo
チームヘルプGet-TeamHelp はいYes はいYes
チームメンバーの設定を取得するGet-TeamMemberSettings 1.0 より前のリリースのみPrior to 1.0 release only いいえNo
チームの Messagingsettings を取得するGet-TeamMessagingSettings 1.0 より前のリリースのみPrior to 1.0 release only いいえNo
チームのユーザーを取得するGet-TeamUser はいYes はいYes
新規-チームNew-Team はいYes はいYes
新しいチームチャネルNew-TeamChannel はいYes はいYes
チームの削除Remove-Team はいYes はいYes
チームの削除のチャネルRemove-TeamChannel はいYes はいYes
チームのユーザーの削除Remove-TeamUser はいYes はいYes
設定-チームSet-Team はいYes はいYes
Set-TeamChannelSet-TeamChannel はいYes はいYes
Set-TeamFunSettingsSet-TeamFunSettings 1.0 より前のリリースのみPrior to 1.0 release only いいえNo
チームのゲスト設定を設定するSet-TeamGuestSettings 1.0 より前のリリースのみPrior to 1.0 release only いいえNo
設定-TeamMemberSettingsSet-TeamMemberSettings 1.0 より前のリリースのみPrior to 1.0 release only いいえNo
設定-TeamMessagingSettingsSet-TeamMessagingSettings 1.0 より前のリリースのみPrior to 1.0 release only いいえNo
設定-TeamPictureSet-TeamPicture はいYes いいえ、計画済みNo, planned

PowerShell を使用したポリシーの管理Managing policies via PowerShell

ポリシーを管理するためのコマンドレットは、 Skype For business コマンドレットモジュールに含まれています。The cmdlets for managing policies are in the Skype for Business cmdlet module.

ポリシーとは、個々のユーザーに適用できる設定のグループです。A policy is a group of settings that can be applied granularly to individual users. 各ポリシーの種類には、ポリシー自体を作成、表示、削除、更新するための独自のコマンドレットのセットがあり、ユーザーにポリシーを割り当てることができます。Each policy type has its own set of cmdlets for creating, viewing, deleting, and updating the policies themselves, and then assigning those policies to users. 一般的な構造は次のとおりです。The general structure is:

  • コマンドの取得 (例Get-CsTeamsMeetingPolicy): 組織内で割り当てることができるポリシードキュメントを返します。これは、使用するために Microsoft によって作成されたポリシーと、作成したカスタムポリシーの両方を返します。GET commands (for example, Get-CsTeamsMeetingPolicy): return the policy documents that are available for you to assign in your organization, both the policies created by Microsoft for you to use and the custom policies you’ve created.

    組織で作成したカスタムポリシーのみを検索する場合は、を使用-Filter "tag:*"できます。If you want to find only the custom policies you’ve created in your organization, you can use -Filter "tag:*".

  • 新しいコマンド (などNew-CsTeamsMeetingPolicy): 組織内のユーザーに割り当てることができる新しいポリシーを作成することができます。NEW commands (for example, New-CsTeamsMeetingPolicy): let you create new policies for your organization that are then available to be assigned to users in your organization. すべてのポリシーでカスタムポリシーの作成がサポートされるわけではありません。Not all policies support the creation of custom policies. 多くの場合、組織で使用しているポリシーの設定の組み合わせがサポートされていることを確認します。Often this is to ensure that the policies you use in your organization have a supported combination of settings.

  • 次のコマンドをSet-CsTeamsMeetingPolicy設定します (例:)。指定したポリシーで特定の値を設定できます。SET commands (for example, Set-CsTeamsMeetingPolicy): lets you set particular values on a given policy. 一部のポリシーでは、set コマンドを使用できないものや、ポリシーでカスタマイズできないパラメーターを含むものもあります。Some policies do not have set commands available, or contain parameters that cannot be customized in the policy. 各 PowerShell の説明では、カスタマイズできないパラメーターを呼び出します。Each PowerShell description will call out which parameters cannot be customized.

    カスタムポリシーが割り当てられていない組織内のユーザーに既定で割り当てられるポリシーを編集するにはSet-Cs<PolicyName> -Identity Global、を実行します。To edit the policy that will by default be assigned to users in your organization who do not have a custom policy assigned, run Set-Cs<PolicyName> -Identity Global.

  • コマンドの削除 (などRemove-CsTeamsMeetingPolicy): このコマンドレットを使用して、テナントで作成されたカスタムポリシーを削除できます。REMOVE commands (for example, Remove-CsTeamsMeetingPolicy): you can use this cmdlet to delete a custom policy that has been created in your tenant. 組織内の1人以上のユーザーに割り当てられているカスタムポリシーを削除すると、そのユーザーはグローバルポリシーに戻ります。If you delete a custom policy that has been assigned to at least one user in your organization, that user will fall back to the global policy.

    組織内のグローバルポリシーを実際に削除することはできませんが、組織内のグローバルポリシーを Microsoft が提供する既定の設定にリセットする場合Remove-Cs<PolicyName> -Identity Globalは、実行できます。You can’t actually remove the global policy in your organization, but if you want to reset the global policy in your organization to the Microsoft-provided default settings, you can run Remove-Cs<PolicyName> -Identity Global.

  • [ Grant-CsTeamsMeetingPolicyGRANT] コマンド (例:): 特定のユーザーにポリシーを割り当てることができます。GRANT command (for example, Grant-CsTeamsMeetingPolicy): lets you assign a policy to a particular user.

    カスタムポリシーの割り当てを削除して、ユーザーが組織の既定のポリシーに戻すようにするGrant-Cs<PolicyName> -Identity <User Identity> -PolicyName $nullには、を実行します。To remove a custom policy assignment and make the user fall back to the default policy in your organization, run Grant-Cs<PolicyName> -Identity <User Identity> -PolicyName $null.

ヒント

すべてのポリシーでカスタムポリシーを作成することはできません。一部のポリシーには、カスタマイズできない設定があります (そのため、設定set-new-表示することはできますが、and でカスタム値を設定することはできません)。Not all policies allow custom policies to be created, and some policies have settings that you can’t customize (so you can view the setting but can’t set a custom value during set- and new-). ユーザーがパラメーターを使用できない場合は、特定のコマンドレットのドキュメントが呼び出されます。The documentation of the specific cmdlet will call out if parameters are not available for use by customers.

一般的なパラメーター:Common parameters:

  • Identity: For Get-Set-, New-、and Remove-identityパラメーターは、常に特定のポリシーインスタンスを参照します。Identity: For Get-, Set-, New-, and Remove-, the Identity parameter will always refer to a specific policy instance. Grant場合、 Identityパラメーターは、ポリシーが適用されている特定のユーザーオブジェクトを参照します。For Grant, the Identity parameter refers to a specific user object to whom the policy is being applied.

PowerShell を使用した構成の管理Managing configurations via PowerShell

構成を管理するためのコマンドレットは、 Skype For business コマンドレットモジュールに含まれています。The cmdlets for managing your configuration are in the Skype for Business cmdlet module.

構成は、サービスに保持されている設定のバケットであり、ユーザーレベルで指定することはできません。Configurations are buckets of settings maintained in the service that cannot be specified at a user level. 設定は組織全体で常に適用されます。Settings always apply across the whole organization. グローバル構成は、組織内で唯一の有効な構成です。Your global configuration is the only effective configuration in your organization. 各構成の種類には、2つの主なコマンドレットが用意されています。Each configuration type comes with two primary cmdlets:

  • Get-Cs<ConfigurationName>(などGet-CsTeamsClientConfiguration):Get-Cs<ConfigurationName> (for example, Get-CsTeamsClientConfiguration):

  • コマンド (例: Set-CsTeamsClientConfiguration) を設定します。その型の構成でプロパティを設定します。SET commands (for example, Set-CsTeamsClientConfiguration): set properties in the configuration of that type. 変更するパラメーターを指定します。Specify the parameters that you want to modify.

    変更している構成は、Id グローバルを指定するか、または実行Get-Cs<ConfigurationName> | Set-Cs<ConfigurationName>して、次の2つの方法のいずれかで参照できます。You can reference the configuration that you’re modifying in one of two ways: by specifying -Identity Global, or by running Get-Cs<ConfigurationName> | Set-Cs<ConfigurationName>.

その他の PowerShell ツールOther PowerShell tools

Microsoft teams コマンドレットリファレンスおよび skype for business の各ポリシーの設定の詳細な説明など、microsoft Teams と Skype for business を管理するためのすべての PowerShell コントロールの使用方法について、詳細な手順を参照してください。 Business コマンドレットリファレンスYou can find detailed instructions on how to use all PowerShell controls for managing Microsoft Teams and Skype for Business, including detailed descriptions of the settings in each policy, in the Microsoft Teams cmdlet reference and Skype for Business cmdlet reference.

詳細情報Learn more