Overzicht van Teams PowerShellTeams PowerShell Overview

Microsoft teams heeft een uitgebreide set hulpprogramma's voor IT-beheerders voor het beheren van het product via de Microsoft-teams Admin Center, PowerShell-besturingselementen en Graph-Api's.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. Deze handleiding wordt uitgelegd hoe we structureren van onze PowerShell-cmdlets voor IT-beheerders te gebruiken, en biedt verwijzingen naar verdere documentatie.This guide explains how we structure our PowerShell cmdlets for IT admins to use, and provides pointers to further documentation. Houd er rekening mee dat verschillende teams admin rollen toegang tot verschillende cmdlets hebben.Note that different Teams admin roles have access to different cmdlets. Zie voor meer informatie, Microsoft-teams admin rollen gebruiken voor het beheren van teams.For more information, see Use Microsoft Teams admin roles to manage Teams.

Welke modules moet u gebruiken?Which modules do you need to use?

De PowerShell-besturingselementen voor het beheren van teams bevinden zich in twee verschillende PowerShell-modules:The PowerShell controls for managing Teams are in two different PowerShell modules:

De naslagdocumentatie voor de PowerShell-besturingselementen ziet u welke module bevat de cmdlet die u wilt onderzoeken.The reference documentation for the PowerShell controls will tell you which module contains the cmdlet you're investigating. (Uiteindelijk zullen de twee modules worden gecombineerd.)(Eventually, the two modules will be combined.)

Wat kan elke beheerdersrol doen?What can each admin role do?

Lees Gebruik Microsoft-teams admin rollen voor het beheren van teams om te begrijpen welke PowerShell-cmdlets verschillende admin rollen kunnen hefboomwerking.Read Use Microsoft Teams admin roles to manage Teams to understand which PowerShell cmdlets different admin roles will be able to leverage.

Teams maken en beheren via PowerShellCreating and managing teams via PowerShell

De cmdlets voor het maken en beheren van teams zijn in de Microsoft-teams PowerShell-module.The cmdlets for creating and managing teams are in the Microsoft Teams PowerShell module.

Teams worden ondersteund door O365-groepen, dus wanneer u een team maakt, maakt u een groep.Teams are backed by O365 Groups, so when you create a team, you create a group. Er zijn een set met cmdlets voor het werken op het core-team en de bijbehorendenew-teaminstellingen get-team( set-team,,), het beherenadd-teamuservan remove-teamuserteam gebruikers (,), evenals cmdlets voor het beheren van de kanalennew-teamchannelvan remove-teamchannelhet team (,).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). Al deze cmdlets kunnen worden uitgevoerd als eindgebruikers, maar ze werken alleen op de teams waarvan u eigenaar bent of die lid zijn van.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. Als u een globale beheerder of teams service beheerder bent, u optreden op alle teams in uw organisatie.If you are a Global Admin or Teams Service Administrator, you'll be able to act on all teams in your organization.

De groupid die wordt gebruikt in de Microsoft-teams PowerShell-module **** -cmdlets is hetzelfde Get-UnifiedGroup als de identiteit eigenschap geretourneerd door in de Exchange PowerShell-module.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.

Verschillen tussen preview en algemeen beschikbare Microsoft-teams PowerShell-moduleDifferences between Preview and Generally Available Microsoft Teams PowerShell Module

Wanneer we onze algemeen beschikbare versie van onze PowerShell-module uitgebracht, zijn een paar cmdlets in de module alleen beta, zoals beschreven in de onderstaande tabel achtergelaten.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.

CmdletCmdlet Beschikbaar in PreviewAvailable in Preview Beschikbaar in 1,0Available in 1.0
Add-team userAdd-TeamUser JaYes JaYes
Connect-MicrosoftTeamsConnect-MicrosoftTeams JaYes JaYes
Verbinding verbreken-MicrosoftTeamsDisconnect-MicrosoftTeams JaYes JaYes
Get-teamGet-Team JaYes JaYes
Get-team ChannelGet-TeamChannel JaYes JaYes
Get-TeamFunSettingsGet-TeamFunSettings Vóór 1,0 release alleenPrior to 1.0 release only NeeNo
Get-TeamGuestSettingsGet-TeamGuestSettings Vóór 1,0 release alleenPrior to 1.0 release only NeeNo
Get-TeamHelpGet-TeamHelp JaYes JaYes
Get-TeamMemberSettingsGet-TeamMemberSettings Vóór 1,0 release alleenPrior to 1.0 release only NeeNo
Get-TeamMessagingSettingsGet-TeamMessagingSettings Vóór 1,0 release alleenPrior to 1.0 release only NeeNo
Get-team userGet-TeamUser JaYes JaYes
Nieuw-teamNew-Team JaYes JaYes
Nieuw-TeamChannelNew-TeamChannel JaYes JaYes
Remove-teamRemove-Team JaYes JaYes
Remove-team ChannelRemove-TeamChannel JaYes JaYes
Verwijderen-TeamUserRemove-TeamUser JaYes JaYes
Set-teamSet-Team JaYes JaYes
Set-team ChannelSet-TeamChannel JaYes JaYes
Set-TeamFunSettingsSet-TeamFunSettings Vóór 1,0 release alleenPrior to 1.0 release only NeeNo
Set-TeamGuestSettingsSet-TeamGuestSettings Vóór 1,0 release alleenPrior to 1.0 release only NeeNo
Set-TeamMemberSettingsSet-TeamMemberSettings Vóór 1,0 release alleenPrior to 1.0 release only NeeNo
Set-TeamMessagingSettingsSet-TeamMessagingSettings Vóór 1,0 release alleenPrior to 1.0 release only NeeNo
Set-TeamPictureSet-TeamPicture JaYes Nee, geplandNo, planned

Beleid beheren via PowerShellManaging policies via PowerShell

De cmdlets voor het beheren van beleid zijn in de Skype voor Business cmdlet-module.The cmdlets for managing policies are in the Skype for Business cmdlet module.

Notitie

De cmdlets is beschikbaar in uw PowerShell-sessie zodra u verbinding met Skype voor Business Online maakt.The cmdlets will be available in your PowerShell session once you connect to Skype for Business Online. Zie Skype voor bedrijven online beheren met Office 365 PowerShellvoor meer informatie.For more information, please see Manage Skype for Business Online with Office 365 PowerShell.

Een beleid is een groep instellingen die granulair kan worden toegepast op individuele gebruikers.A policy is a group of settings that can be applied granularly to individual users. Elk beleidstype heeft een eigen set cmdlets voor het maken, weergeven, verwijderen en bijwerken van het beleid zelf, en vervolgens toewijzen van deze beleidsregels aan gebruikers.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. De algemene structuur is:The general structure is:

  • GET-opdrachten (bijvoorbeeld Get-CsTeamsMeetingPolicy): retourneren de beleidsdocumenten die beschikbaar zijn voor u om toe te wijzen in uw organisatie, zowel het beleid dat door Microsoft is gemaakt voor u te gebruiken en het aangepaste beleid dat u hebt gemaakt.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.

    Als u alleen het aangepaste beleid dat u hebt gemaakt in uw organisatie wilt vinden, u gebruiken -Filter "tag:*".If you want to find only the custom policies you’ve created in your organization, you can use -Filter "tag:*".

  • NIEUWE opdrachten (bijvoorbeeld New-CsTeamsMeetingPolicy): u nieuwe beleidsregels maken voor uw organisatie die vervolgens beschikbaar zijn om te worden toegewezen aan gebruikers in uw organisatie.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. Niet alle beleidsregels ondersteunen het maken van aangepaste beleidsregels.Not all policies support the creation of custom policies. Dit is vaak om ervoor te zorgen dat het beleid dat u in uw organisatie gebruikt een ondersteunde combinatie van instellingen heeft.Often this is to ensure that the policies you use in your organization have a supported combination of settings.

  • SET-opdrachten (bijvoorbeeld Set-CsTeamsMeetingPolicy): Hiermee u bepaalde waarden instellen voor een bepaald beleid.SET commands (for example, Set-CsTeamsMeetingPolicy): lets you set particular values on a given policy. Sommige beleidsregels hebben geen set-opdrachten beschikbaar of bevatten parameters die niet kunnen worden aangepast in het beleid.Some policies do not have set commands available, or contain parameters that cannot be customized in the policy. Elke PowerShell-beschrijving wordt opgeroepen welke parameters kunnen niet worden aangepast.Each PowerShell description will call out which parameters cannot be customized.

    Om het beleid te bewerken dat standaard wordt toegewezen aan gebruikers in uw organisatie die geen aangepast beleid hebben toegewezen, worden uitgevoerd 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.

  • Opdrachten verwijderen (bijvoorbeeld Remove-CsTeamsMeetingPolicy): u deze cmdlet gebruiken voor het verwijderen van een aangepast beleid dat is gemaakt in uw Tenant.REMOVE commands (for example, Remove-CsTeamsMeetingPolicy): you can use this cmdlet to delete a custom policy that has been created in your tenant. Als u een aangepast beleid dat is toegewezen aan ten minste één gebruiker in uw organisatie verwijdert, wordt die gebruiker terugvallen op het globale beleid.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.

    U het globale beleid in uw organisatie niet daadwerkelijk verwijderen, maar als u het globale beleid in uw organisatie opnieuw wilt instellen op de door Microsoft geleverde standaardinstellingen, Remove-Cs<PolicyName> -Identity Globalkan dit worden uitgevoerd.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, Grant-CsTeamsMeetingPolicyopdracht (bijvoorbeeld): Hiermee u een beleid toewijzen aan een bepaalde gebruiker.GRANT command (for example, Grant-CsTeamsMeetingPolicy): lets you assign a policy to a particular user.

    Als u een aangepaste beleidstoewijzing wilt verwijderen en de gebruiker terug wilt laten vallen in het standaardbeleid in uw Grant-Cs<PolicyName> -Identity <User Identity> -PolicyName $nullorganisatie, voert u deze uit.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.

Tip

Niet alle beleidsregels toestaan dat aangepaste beleidsregels worden gemaakt en sommige beleidsregels hebben instellingen die u niet aanpassen (zodat u de instelling kan bekijken, maar kan geen set- aangepaste new-waarde instellen tijdens en).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-). De documentatie van de specifieke cmdlet wordt opgeroepen als parameters niet beschikbaar voor gebruik door klanten zijn.The documentation of the specific cmdlet will call out if parameters are not available for use by customers.

Gemeenschappelijke parameters:Common parameters:

  • Identiteit: voor Get-, Set-, New-, en Remove-, de Identity parameter verwijst altijd naar een specifieke beleidsinstantie.Identity: For Get-, Set-, New-, and Remove-, the Identity parameter will always refer to a specific policy instance. Voor Grant, de Identity parameter verwijst naar een specifiek gebruikersobject waarop het beleid wordt toegepast.For Grant, the Identity parameter refers to a specific user object to whom the policy is being applied.

Configuraties beheren via PowerShellManaging configurations via PowerShell

De cmdlets voor het beheren van uw configuratie zijn in de Skype voor Business cmdlet-module.The cmdlets for managing your configuration are in the Skype for Business cmdlet module.

Configuraties zijn buckets van instellingen die worden bijgehouden in de service die niet kan worden opgegeven op gebruikersniveau.Configurations are buckets of settings maintained in the service that cannot be specified at a user level. Instellingen zijn altijd van toepassing in de hele organisatie.Settings always apply across the whole organization. Uw algemene configuratie is de enige effectieve configuratie in uw organisatie.Your global configuration is the only effective configuration in your organization. Elk Configuratietype wordt geleverd met twee primaire cmdlets:Each configuration type comes with two primary cmdlets:

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

  • Opdrachten instellen (bijvoorbeeld Set-CsTeamsClientConfiguration): eigenschappen instellen in de configuratie van dat type.SET commands (for example, Set-CsTeamsClientConfiguration): set properties in the configuration of that type. Geef de parameters op die u wilt wijzigen.Specify the parameters that you want to modify.

    U verwijzen naar de configuratie die u op een van de twee manieren wijzigen: door op te geven-Identity Global, Get-Cs<ConfigurationName> | Set-Cs<ConfigurationName>of door te voeren.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>.

Andere PowerShell-hulpprogramma'sOther PowerShell tools

U vindt gedetailleerde instructies over het gebruik van alle PowerShell-besturingselementen voor het beheren van Microsoft-teams en Skype voor bedrijven, met inbegrip van gedetailleerde beschrijvingen van de instellingen in elk beleid, in de Microsoft-teams cmdlet Reference en Skype voor Business cmdlet verwijzing.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.

Meer informatieLearn more