Übersicht über PowerShell für Microsoft TeamsTeams PowerShell Overview

Microsoft Teams verfügt über eine umfangreiche Reihe von Tools für IT-Administratoren, um das Produkt über das Microsoft Teams Admin Center, PowerShell-Steuerelemente und Diagramm-APIs zu verwalten.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. In diesem Leitfaden wird erläutert, wie wir unsere PowerShell-Cmdlets für IT-Administratoren strukturieren und Verweise auf weitere Dokumentationen bereitstellen.This guide explains how we structure our PowerShell cmdlets for IT admins to use, and provides pointers to further documentation. Beachten Sie, dass verschiedene Teams-Administratorrollen Zugriff auf verschiedene Cmdlets haben.Note that different Teams admin roles have access to different cmdlets. Weitere Informationen finden Sie unter Verwenden von Microsoft Teams-Administratorrollen zum Verwalten von Teams.For more information, see Use Microsoft Teams admin roles to manage Teams.

Welche Module müssen Sie verwenden?Which modules do you need to use?

Die PowerShell-Steuerelemente für die Verwaltung von Teams sind in zwei verschiedenen PowerShell-Modulen zu finden:The PowerShell controls for managing Teams are in two different PowerShell modules:

In der Referenzdokumentation zu den PowerShell-Steuerelementen erfahren Sie, welches Modul das Cmdlet enthält, das Sie untersuchen.The reference documentation for the PowerShell controls will tell you which module contains the cmdlet you're investigating. (Schließlich werden die beiden Module kombiniert.)(Eventually, the two modules will be combined.)

Was kann jede Administratorrolle tun?What can each admin role do?

Lesen verwenden Sie Microsoft Teams-Administratorrollen zum Verwalten von Teams , um zu verstehen, welche PowerShell-Cmdlets von verschiedenen Administratorrollen genutzt werden können.Read Use Microsoft Teams admin roles to manage Teams to understand which PowerShell cmdlets different admin roles will be able to leverage.

Erstellen und Verwalten von Teams über PowerShellCreating and managing teams via PowerShell

Die Cmdlets zum Erstellen und Verwalten von Teams befinden sich im PowerShell-Modul von Microsoft Teams.The cmdlets for creating and managing teams are in the Microsoft Teams PowerShell module.

Teams werden von Office 365-Gruppen gesichert, sodass Sie beim Erstellen eines Teams eine Gruppe erstellen.Teams are backed by O365 Groups, so when you create a team, you create a group. Es gibt eine Reihe von Cmdlets, die für das Funktionieren des Kernteams und dessennew-teamEinstellungen get-team( set-team,,), Verwalten vonadd-teamuserTeam remove-teamuserBenutzern (,) sowie Cmdlets für die Verwaltung der Kanäle des Teams (new-teamchannel, remove-teamchannel) bereitgestellt werden.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). Alle diese Cmdlets können als Endbenutzer ausgeführt werden, funktionieren aber nur in den Teams, denen Sie angehören oder deren Mitglied Sie sind.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. Wenn Sie ein globaler Administrator oder Team Dienst Administrator sind, können Sie auf alle Teams in Ihrer Organisation zugreifen.If you are a Global Admin or Teams Service Administrator, you'll be able to act on all teams in your organization.

Die in den Microsoft Teams PowerShell-Modul-Cmdlets verwendete Gruppen -ID ist mit der im Exchange PowerShell Get-UnifiedGroup -Modul zurückgegebenen Identity -Eigenschaft identisch.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.

Unterschiede zwischen Preview und im allgemeinen verfügbaren Microsoft Teams PowerShell-ModulDifferences between Preview and Generally Available Microsoft Teams PowerShell Module

Als wir unsere allgemein verfügbare Version unseres PowerShell-Moduls veröffentlichten, blieben einige Cmdlets im Beta-only-Modul wie in der nachstehenden Tabelle beschrieben.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 In der Vorschau verfügbarAvailable in Preview Verfügbar in 1,0Available in 1.0
Add-TeamUserAdd-TeamUser JaYes JaYes
Connect-Microsoft TeamsConnect-MicrosoftTeams JaYes JaYes
Trennen-Microsoft TeamsDisconnect-MicrosoftTeams JaYes JaYes
Get-TeamGet-Team JaYes JaYes
Get-TeamChannelGet-TeamChannel JaYes JaYes
Get-TeamFunSettingsGet-TeamFunSettings Vor der 1,0-VersionPrior to 1.0 release only NeinNo
Get-TeamGuestSettingsGet-TeamGuestSettings Vor der 1,0-VersionPrior to 1.0 release only NeinNo
Get-TeamHelpGet-TeamHelp JaYes JaYes
Get-TeamMemberSettingsGet-TeamMemberSettings Vor der 1,0-VersionPrior to 1.0 release only NeinNo
Get-TeamMessagingSettingsGet-TeamMessagingSettings Vor der 1,0-VersionPrior to 1.0 release only NeinNo
Get-TeamUserGet-TeamUser JaYes JaYes
Neues TeamNew-Team JaYes JaYes
Neu – TeamChannelNew-TeamChannel JaYes JaYes
Remove-TeamRemove-Team JaYes JaYes
Remove-TeamChannelRemove-TeamChannel JaYes JaYes
Remove-TeamUserRemove-TeamUser JaYes JaYes
Team einrichtenSet-Team JaYes JaYes
Satz-TeamChannelSet-TeamChannel JaYes JaYes
Satz-TeamFunSettingsSet-TeamFunSettings Vor der 1,0-VersionPrior to 1.0 release only NeinNo
Satz-TeamGuestSettingsSet-TeamGuestSettings Vor der 1,0-VersionPrior to 1.0 release only NeinNo
Satz-TeamMemberSettingsSet-TeamMemberSettings Vor der 1,0-VersionPrior to 1.0 release only NeinNo
Satz-TeamMessagingSettingsSet-TeamMessagingSettings Vor der 1,0-VersionPrior to 1.0 release only NeinNo
Satz-TeamPictureSet-TeamPicture JaYes Nein, geplantNo, planned

Verwalten von Richtlinien über PowerShellManaging policies via PowerShell

Die Cmdlets für die Verwaltung von Richtlinien sind im Skype for Business-Cmdlet-Modulzu finden.The cmdlets for managing policies are in the Skype for Business cmdlet module.

Hinweis

Die Cmdlets sind in ihrer PowerShell-Sitzung verfügbar, nachdem Sie eine Verbindung mit Skype for Business Online hergestellt haben.The cmdlets will be available in your PowerShell session once you connect to Skype for Business Online. Weitere Informationen finden Sie unter Verwalten von Skype for Business Online mit Office 365 PowerShell.For more information, please see Manage Skype for Business Online with Office 365 PowerShell.

Bei einer Richtlinie handelt es sich um eine Gruppe von Einstellungen, die auf einzelne Benutzer Granular angewendet werden können.A policy is a group of settings that can be applied granularly to individual users. Jeder Richtlinientyp verfügt über einen eigenen Satz von Cmdlets zum Erstellen, anzeigen, löschen und Aktualisieren der Richtlinien selbst und zum Zuweisen dieser Richtlinien zu Benutzern.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. Die allgemeine Struktur lautet:The general structure is:

  • Abrufen von Befehlen (beispielsweise Get-CsTeamsMeetingPolicy): Geben Sie die Richtliniendokumente zurück, die für Sie in Ihrer Organisation zur Verfügung stehen, sowohl die von Microsoft für Sie erstellten Richtlinien als auch die von Ihnen erstellten benutzerdefinierten Richtlinien.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.

    Wenn Sie nur die benutzerdefinierten Richtlinien finden möchten, die Sie in Ihrer Organisation erstellt haben, -Filter "tag:*"können Sie Sie verwenden.If you want to find only the custom policies you’ve created in your organization, you can use -Filter "tag:*".

  • Neue Befehle (beispielsweise New-CsTeamsMeetingPolicy): Sie können neue Richtlinien für Ihre Organisation erstellen, die dann Benutzern in Ihrer Organisation zugewiesen werden können.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. Nicht alle Richtlinien unterstützen das Erstellen benutzerdefinierter Richtlinien.Not all policies support the creation of custom policies. Häufig wird dadurch sichergestellt, dass die in Ihrer Organisation verwendeten Richtlinien eine unterstützte Kombination von Einstellungen aufweisen.Often this is to ensure that the policies you use in your organization have a supported combination of settings.

  • Festlegen von Befehlen (beispielsweise Set-CsTeamsMeetingPolicy): Hiermit können Sie bestimmte Werte für eine bestimmte Richtlinie festlegen.SET commands (for example, Set-CsTeamsMeetingPolicy): lets you set particular values on a given policy. Für einige Richtlinien sind keine festgelegten Befehle verfügbar, oder es sind keine Parameter enthalten, die in der Richtlinie nicht angepasst werden können.Some policies do not have set commands available, or contain parameters that cannot be customized in the policy. Jede PowerShell-Beschreibung gibt an, welche Parameter nicht angepasst werden können.Each PowerShell description will call out which parameters cannot be customized.

    Wenn Sie die Richtlinie bearbeiten möchten, die standardmäßig Benutzern in Ihrer Organisation zugewiesen wird, denen keine benutzerdefinierte Richtlinie zugewiesen Set-Cs<PolicyName> -Identity Globalist, führen Sie Sie aus.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.

  • Entfernen von Befehlen (beispielsweise Remove-CsTeamsMeetingPolicy): Sie können dieses Cmdlet verwenden, um eine benutzerdefinierte Richtlinie zu löschen, die in Ihrem Mandanten erstellt wurde.REMOVE commands (for example, Remove-CsTeamsMeetingPolicy): you can use this cmdlet to delete a custom policy that has been created in your tenant. Wenn Sie eine benutzerdefinierte Richtlinie löschen, die mindestens einem Benutzer in Ihrer Organisation zugewiesen wurde, wird dieser Benutzer auf die globale Richtlinie zurückgreifen.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.

    Sie können die globale Richtlinie in Ihrer Organisation nicht wirklich entfernen, aber wenn Sie die globale Richtlinie in Ihrer Organisation auf die von Microsoft bereitgestellten Standardeinstellungen zurück Remove-Cs<PolicyName> -Identity Globalsetzen möchten, können Sie ausführen.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-Befehl (beispielsweise Grant-CsTeamsMeetingPolicy): Hiermit können Sie einem bestimmten Benutzer eine Richtlinie zuweisen.GRANT command (for example, Grant-CsTeamsMeetingPolicy): lets you assign a policy to a particular user.

    Um eine benutzerdefinierte Richtlinienzuweisung zu entfernen und den Benutzer auf die Standardrichtlinie in Ihrer Organisation zurückgreifen zu Grant-Cs<PolicyName> -Identity <User Identity> -PolicyName $nulllassen, führen Sie.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.

Tipp

Nicht alle Richtlinien ermöglichen das Erstellen benutzerdefinierter Richtlinien, und einige Richtlinien verfügen über Einstellungen, die Sie nicht anpassen können (sodass Sie die Einstellung anzeigen, set- aber new-keinen benutzerdefinierten Wert während und festlegen können).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-). Die Dokumentation des jeweiligen Cmdlets Ruft ab, wenn Parameter nicht für die Verwendung durch Kunden verfügbar sind.The documentation of the specific cmdlet will call out if parameters are not available for use by customers.

Allgemeine Parameter:Common parameters:

  • Identity: für Get-, Set-, New-, und Remove-der Parameter Identity bezieht sich immer auf eine bestimmte Richtlinieninstanz.Identity: For Get-, Set-, New-, and Remove-, the Identity parameter will always refer to a specific policy instance. GrantDer Parameter Identity bezieht sich auf ein bestimmtes Benutzerobjekt, auf das die Richtlinie angewendet wird.For Grant, the Identity parameter refers to a specific user object to whom the policy is being applied.

Verwalten von Konfigurationen über PowerShellManaging configurations via PowerShell

Die Cmdlets für die Verwaltung Ihrer Konfiguration sind im Skype for Business-Cmdlet-Modulzu finden.The cmdlets for managing your configuration are in the Skype for Business cmdlet module.

Konfigurationen sind Buckets von Einstellungen, die im Dienst verwaltet werden und nicht auf Benutzerebene angegeben werden können.Configurations are buckets of settings maintained in the service that cannot be specified at a user level. Einstellungen gelten immer für die gesamte Organisation.Settings always apply across the whole organization. Ihre globale Konfiguration ist die einzige effektive Konfiguration in Ihrer Organisation.Your global configuration is the only effective configuration in your organization. Jeder Konfigurationstyp enthält zwei primäre Cmdlets:Each configuration type comes with two primary cmdlets:

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

  • Befehlssatz (beispielsweise Set-CsTeamsClientConfiguration): legt Eigenschaften in der Konfiguration dieses Typs fest.SET commands (for example, Set-CsTeamsClientConfiguration): set properties in the configuration of that type. Geben Sie die Parameter an, die Sie ändern möchten.Specify the parameters that you want to modify.

    Sie können auf die zu ändernde Konfiguration auf eine von zwei Arten verweisen: durch Angeben von-Identity Globaloder durch Ausführen 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>.

Andere PowerShell-ToolsOther PowerShell tools

Ausführliche Anweisungen zur Verwendung aller PowerShell-Steuerelemente für die Verwaltung von Microsoft Teams und Skype for Business, einschließlich detaillierter Beschreibungen der Einstellungen in den einzelnen Richtlinien, finden Sie in der Microsoft Teams-Cmdlet-Referenz und in Skype für Business-Cmdlet-Referenz.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.

Weitere InformationenLearn more