Управление Teams с помощью Microsoft Teams PowerShell

В этой статье показано, как использовать Microsoft Teams PowerShell для управления Teams.

Используйте это руководство вместе со справочником по командлетам Microsoft Teams.

Сведения об управлении Teams в Центре администрирования Teams см. в статье Управление Teams с помощью Azure Cloud Shell.

Создание команд и управление ими с помощью PowerShell

Командлеты для создания команд и управления ими находятся в модуле Microsoft Teams PowerShell.

Команды поддерживаются группами Office 365, поэтому при создании команды вы создаете группу. Существует набор командлетов для работы с основной командой и ее параметрами (new-team, , ), set-teamуправление пользователями команды (add-teamuser, remove-teamuser), а также командлеты для управления каналами команды (new-teamchannel, remove-teamchannelget-team). Все эти командлеты могут выполняться от имени конечных пользователей, но они будут работать только в командах, в которых вы являетесь владельцем или членом которых вы являетесь. Если вы являетесь глобальным Администратор или администратором Teams, вы сможете действовать во всех командах в вашей организации.

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

Примечание.

Идентификатор GroupId, используемый в командлетах модуля Microsoft Teams PowerShell, совпадает со свойством Identity, возвращенным Get-UnifiedGroup в модуле Exchange PowerShell.

Управление Teams с помощью Azure Cloud Shell

Cloud Shell — это интерактивная оболочка с проверкой подлинности, доступная в браузере, которая позволяет управлять ресурсами. Дополнительные сведения о Cloud Shell см. в статье Azure Cloud Shell.

Чтобы получить доступ к Cloud Shell Azure и использовать PowerShell для управления Teams, войдите в Центр администрирования Teams.

  1. Щелкните значок Cloud Shell в правом верхнем углу.

    Снимок экрана: заголовок Центра администрирования Teams со значком Cloud Shell.

  2. При появлении запроса выберите PowerShell.

    Снимок экрана: запрос Cloud Shell Azure.

  3. Выполните следующую команду, чтобы запустить сеанс Teams PowerShell:

    Connect-MicrosoftTeams
    

После выполнения этих действий вы сможете выполнять команды PowerShell Teams.

Важно!

Если вы хотите использовать командлеты Cs*, сначала необходимо подключиться к Teams с помощью Connect-MicrosoftTeams -UseDeviceAuthentication команды .

Управление политиками с помощью PowerShell

Найдите командлеты для управления политиками в модуле командлетов Microsoft Teams.

Политика — это группа параметров, которые можно детально применять к отдельным пользователям. Каждый тип политики имеет собственный набор командлетов для создания, просмотра, удаления и обновления самих политик, а затем назначения этих политик пользователям. Общая структура:

  • Команды GET (например, ): возвращает документы политики, Get-CsTeamsMeetingPolicyдоступные для назначения в организации, включая политики, созданные корпорацией Майкрософт для использования, а также пользовательские политики, которые вы создали.

    • Чтобы найти только пользовательские политики, созданные в организации, используйте -Filter "tag:*".
  • КОМАНДЫ NEW (например, New-CsTeamsMeetingPolicy): создает новые политики для вашей организации для назначения пользователям в вашей организации. Не все политики поддерживают создание пользовательских политик. Часто это необходимо для того, чтобы политики, используемые в организации, имели поддерживаемое сочетание параметров.

  • Команды SET (например, Set-CsTeamsMeetingPolicy): задает определенные значения для заданной политики. Некоторые политики не имеют доступных команд SET или содержат параметры, которые невозможно настроить в политике. В описаниях PowerShell показано, какие параметры нельзя настроить.

    • Чтобы изменить политику, которая по умолчанию будет назначена пользователям в организации, которым не назначена настраиваемая политика, выполните команду Set-Cs<PolicyName> -Identity Global.
  • Команды REMOVE (например, Remove-CsTeamsMeetingPolicy): удаляет пользовательскую политику, созданную в клиенте. При удалении настраиваемой политики, назначенной по крайней мере одному пользователю в организации, этот пользователь вернется к глобальной политике.

    • Вы не можете удалить глобальную политику в своей организации, но если вы хотите сбросить глобальную политику в организации до параметров по умолчанию, предоставленных Майкрософт, выполните команду Remove-Cs<PolicyName> -Identity Global.
  • Команда GRANT (например, Grant-CsTeamsMeetingPolicy): назначает политику конкретному пользователю.

    • Чтобы удалить назначение настраиваемой политики и заставить пользователя вернуться к политике по умолчанию в организации, выполните команду Grant-Cs<PolicyName> -Identity <User Identity> -PolicyName $null.

Совет

Не все политики позволяют создавать пользовательские политики, а некоторые политики имеют параметры, которые невозможно настроить (поэтому вы можете просмотреть параметр, но не можете задать пользовательское значение во время set- и new-). Документация по каждому командлету определяет, доступны ли параметры для использования клиентами.

Общие параметры:

  • Identity. Для Get-, Set-, New-и Remove-параметр Identity всегда будет ссылаться на конкретный экземпляр политики. Для Grantпараметр Identity относится к конкретному объекту пользователя, к которому применяется политика.

Управление конфигурациями с помощью PowerShell

Найдите командлеты для управления конфигурацией в модуле командлетов Microsoft Teams.

Конфигурации — это контейнеры параметров, хранящееся в службе, которые нельзя указать на уровне пользователя. Параметры всегда применяются во всей организации. Ваша глобальная конфигурация является единственной эффективной конфигурацией в вашей организации. Каждый тип конфигурации поставляется с двумя основными командлетами:

  • Get-Cs<ConfigurationName> (например, Get-CsTeamsClientConfiguration):

  • Команды SET (например, Set-CsTeamsClientConfiguration): задают свойства в конфигурации этого типа. Укажите параметры, которые требуется изменить.

    Примечание.

    Вы можете ссылаться на изменяемую конфигурацию одним из двух способов: путем указания параметра -Identity Global или запуска Get-Cs<ConfigurationName> | Set-Cs<ConfigurationName>.

Что может сделать каждая роль администратора?

См . статью Использование ролей администратора Microsoft Teams для управления Teams , чтобы понять, какие роли администратора могут запускать каждый командлет PowerShell.

Установка Teams PowerShell

Заметки о выпуске Teams PowerShell

Справочник по командлетам Teams

Управление Teams с ролями администратора