Microsoft Teams PowerShell을 사용하여 Teams 관리Manage Teams with Microsoft Teams PowerShell

이 문서에서는 Microsoft Teams PowerShell을 사용하여 Teams 및 비즈니스용 Skype를 관리하는 방법을 보여줍니다.This article shows you how to use Microsoft Teams PowerShell to manage Teams and Skype for Business.

이 지침은 Microsoft Teams cmdlet 참조비즈니스용 Skype cmdlet 참조와 함께 사용하세요.Use this guidance in conjunction with the Microsoft Teams cmdlet reference and Skype for Business cmdlet reference.

PowerShell을 사용하여 팀 만들기 및 관리Create and manage teams using PowerShell

팀을 만들고 관리하기 위한 cmdlet은 Microsoft Teams PowerShell 모듈에 있습니다.The cmdlets for creating and managing teams are in the Microsoft Teams PowerShell module.

Teams는 Office 365 그룹에서 백업됩니다. 따라서 팀을 만들 때 그룹을 만들 수 있습니다.Teams are backed by Office 365 Groups, so when you create a team, you create a group. 핵심 팀 및 해당 설정(, , 팀 사용자 관리), 팀 사용자 관리( 및 팀 채널 관리)를 위해 제공되는 new-team get-team set-team cmdlet 집합이 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). 이러한 cmdlet은 모두 최종 사용자로 실행할 수 있지만 사용자가 소유하거나 구성원인 팀에서만 작업합니다.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.

New-Team -Name "Contoso Marketing" -Description "Collaboration space for Contoso's Marketing department"

Microsoft Teams PowerShell 모듈 cmdlet에 사용되는 GroupId는 Exchange PowerShell 모듈에서 반환된 ID 속성과 Get-UnifiedGroup 동일합니다.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.

PowerShell을 통해 정책 관리Manage policies via PowerShell

참고

  • 비즈니스용 Skype Online Connector가 Teams PowerShell에 통합되고 있습니다.Skype for Business Online Connector is being consolidated into Teams PowerShell. 현재 공개 미리 보기로 제공됩니다.It is currently available in public preview. Teams에 적용되는 비즈니스용 Skype Online cmdlet은 Teams PowerShell 모듈에서 기본적으로 사용할 수 있습니다.In time, Skype for Business Online cmdlets that apply to Teams will be natively available in the Teams PowerShell module. 설치 단계는 Teams PowerShell 설치 문서에서 사용할 수 있습니다.Installation steps are available in the Install Teams PowerShell article.

  • 비즈니스용 Skype Online에 연결하면 PowerShell 세션에서 cmdlet을 사용할 수 있습니다.The cmdlets will be available in your PowerShell session once you connect to Skype for Business Online. 자세한 내용은 Office 365 PowerShell을사용하여 비즈니스용 Skype Online 관리를 참조하세요.For more information, please see Manage Skype for Business Online with Office 365 PowerShell.

비즈니스용 Skype cmdlet 모듈에서 정책을 관리하기 위한 cmdlet을 찾을 수 있습니다.Find the cmdlets for managing policies in the Skype for Business cmdlet module.

정책은 개별 사용자에게 세분화하여 적용할 수 있는 설정 그룹입니다.A policy is a group of settings that can be applied granularly to individual users. 각 정책 유형에는 정책 자체를 만들고, 보고, 삭제하고, 업데이트한 다음, 사용자에게 해당 정책을 할당하기 위한 고유한 cmdlet 집합이 있습니다.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 명령(예: ): Microsoft에서 만든 정책 및 만든 사용자 지정 정책을 포함하여 조직에서 할당할 수 있는 정책 문서를 Get-CsTeamsMeetingPolicy 반환합니다.GET commands (for example, Get-CsTeamsMeetingPolicy): Returns the policy documents that are available for you to assign in your organization, including the policies created by Microsoft for you to use as well as the custom policies you’ve created.

    • 조직에서 만든 사용자 지정 정책만 찾으면 을(를) 사용 -Filter "tag:*" 합니다.To find only the custom policies you’ve created in your organization, use -Filter "tag:*".
  • 명령(예: ): 조직의 사용자에게 할당할 새 New-CsTeamsMeetingPolicy 정책을 만듭니다.NEW commands (for example, New-CsTeamsMeetingPolicy): Creates new policies for your organization to assign 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 명령(예: Set-CsTeamsMeetingPolicy ): 주어진 정책에서 특정 값을 설정합니다.SET commands (for example, Set-CsTeamsMeetingPolicy): Sets particular values on a given policy. 일부 정책에는 SET 명령을 사용할 수 없는 경우도 있습니다. 또는 정책에서 사용자 지정할 수 없는 매개 변수가 포함되어 있습니다.Some policies don't have SET commands available, or they contain parameters that can't be customized in the policy. PowerShell 설명은 사용자 지정할 수 없는 매개 변수를 나타냅니다.The PowerShell descriptions tell you which parameters can't 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 명령(예: ): 테넌트에서 만든 사용자 지정 정책을 Remove-CsTeamsMeetingPolicy 삭제합니다.REMOVE commands (for example, Remove-CsTeamsMeetingPolicy): Deletes a custom policy that has been created in your tenant. 조직에서 하나 이상의 사용자에게 할당된 사용자 지정 정책을 삭제하는 경우 해당 사용자는 전역 정책으로 되돌아가게 됩니다.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, run Remove-Cs<PolicyName> -Identity Global.
  • GRANT 명령(예: ): 특정 사용자에게 정책을 Grant-CsTeamsMeetingPolicy 할당합니다.GRANT command (for example, Grant-CsTeamsMeetingPolicy): Assigns 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- 없습니다).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-). 각 cmdlet에 대한 설명서는 고객이 매개 변수를 사용할 수 있는지 여부를 호출합니다.The documentation for each cmdlet calls out whether parameters are available for use by customers.

일반적인 매개 변수:Common parameters:

  • ID: ID 매개 변수의 경우, 및 ID 매개 변수는 항상 특정 정책 Get- Set- New- Remove- 인스턴스를 참조합니다. Identity: For Get-, Set-, New-, and Remove-, the Identity parameter will always refer to a specific policy instance. 이 경우 ID 매개 변수는 정책을 적용하는 특정 사용자 Grant 개체를 나타냅니다. For Grant, the Identity parameter refers to a specific user object to whom the policy is being applied.

PowerShell을 통해 구성 관리Manage configurations via PowerShell

비즈니스용 Skype cmdlet 모듈에서 구성을 관리하기 위한 cmdlet을 찾을 수 있습니다.Find the cmdlets for managing your configuration in the Skype for Business cmdlet module.

구성은 사용자 수준에서 지정할 수 없는 서비스에서 유지 관리되는 설정의 버킷입니다.Configurations are buckets of settings maintained in the service that can't be specified at a user level. 설정은 항상 전체 조직에 적용됩니다.Settings always apply across the whole organization. 전역 구성은 조직에서 유일하게 효과적인 구성입니다.Your global configuration is the only effective configuration in your organization. 각 구성 유형에는 두 가지 기본 cmdlet이 함께 있습니다.Each configuration type comes with two primary cmdlets:

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

  • SET 명령(예: 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> 있습니다.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>.

각 관리자 역할은 무엇을 할 수 있나요?What can each admin role do?

Microsoft Teams 관리자 역할을 사용하여 Teams를 관리하여 각 PowerShell cmdlet을 실행할 수 있는 관리자 역할을 이해합니다.Read Use Microsoft Teams admin roles to manage Teams to understand which admin roles can run each PowerShell cmdlet.

Teams PowerShell 설치Installing Teams PowerShell

Teams PowerShell 릴리스 정보Teams PowerShell Release Notes

Teams cmdlet 참조Teams cmdlet reference

비즈니스용 Skype cmdlet 참조Skype for Business cmdlet reference

Teams 관리자 역할을 사용하여 Teams를 관리Use Teams admin roles to manage Teams