Поделиться через


Set-App

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

Командлет Set-App используется для изменения доступности приложений организации.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Set-App
   [-Identity] <AppIdParameter>
   [-Confirm]
   [-DefaultStateForUser <DefaultStateForUser>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-OrganizationApp]
   [-PrivateCatalog]
   [-ProvidedTo <ClientExtensionProvidedTo>]
   [-UserList <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Командлет Set-App может использоваться только при настройке доступности приложения организации. Для выполнения этой задачи требуется, чтобы указанное приложение уже было установлено (например, приложение было установлено с помощью командлета New-App или что оно является приложением по умолчанию для Outlook).

Приложения по умолчанию в Outlook в Интернете и приложения, установленные для использования пользователями в организации, называются приложениями организации. Приложения организации не могут быть удалены пользователем, но их можно включать и отключать. У приложений организации (область по умолчанию или организация) элемент управления удалением на панели инструментов недоступен пользователям. Только администраторам доступна возможность удалять приложения организации. Но администраторы не могут удалять приложения, установленные по умолчанию, хотя могут отключить их для всей организации.

Дополнительные сведения см. в разделах Управление доступом пользователей к надстройкам для Outlook в Exchange Server и Управление развертыванием надстроек в Центр администрирования Microsoft 365.

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

$a= Get-DistributionGroupMember -Identity "Finance Team"

Set-App -OrganizationApp -Identity 3f10017a-9bbe-4a23-834b-6a8fe3af0e37 -ProvidedTo SpecificUsers -UserList $a.Identity -DefaultStateForUser Enabled

Эта команда изменяет приложение FinanceTestApp, которое было установлено для всех в организации, чтобы оно было доступно участникам группы Finance Team и было включено по умолчанию.

Пример 2

Set-App -OrganizationApp -Identity 3f10017a-9bbe-4a23-834b-6a8fe3af0e37 -Enabled $false

Эта команда отключает приложение FinanceTestApp для всех членов организации и скрывает его от пользователей.

Параметры

-Confirm

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.

  • Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DefaultStateForUser

Параметр DefaultStateForUser определяет начальное состояние приложений организации по умолчанию для указанных пользователей. Допустимые значения:

  • Enabled. Приложение организации включено.
  • Отключено: приложение организации отключено. Это значение используется по умолчанию.
  • AlwaysEnabled: приложение организации включено, и пользователи не могут его отключить.

Этот параметр можно использовать вместе с параметром OrganizationApp.

Type:DefaultStateForUser
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

Этот параметр доступен только в локальной среде Exchange.

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Enabled

Параметр Enabled указывает, доступно ли приложение пользователям в организации. Допустимые значения:

  • $true: приложение включено для указанных пользователей. Это значение используется по умолчанию.
  • $false. Приложение не включено для пользователей в организации. Это позволяет скрыть приложение из пользовательского представления для всех пользователей.

Эта настройка переопределяет параметры ProvidedTo, UserList и DefaultStateForUser. Этот параметр не ограничивает пользователей в установке собственных экземпляров приложения, если у них есть разрешение на установку.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

Параметр Identity указывает AppID (значение GUID) приложения, которое нужно изменить. Чтобы найти значение GUID приложения, выполните команду Get-App | Format-Table -Auto DisplayName,AppId.

Type:AppIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-OrganizationApp

Параметр OrganizationApp указывает, что область приложения — это область организации (она не привязана к конкретному пользователю). Указывать значение для этого параметра необязательно.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-PrivateCatalog

Параметр PrivateCatalog указывает на то, что приложение, которое вы хотите изменить, находится в частном каталоге. Для этого переключателя не требуется указывать значение.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-ProvidedTo

Параметр ProvidedTo указывает доступность приложения в организации. Допустимые значения:

  • Все: приложение предоставляется каждому пользователю в организации. Это значение используется по умолчанию. Каждый пользователь видит это приложение в списке установленных приложений в разделе Параметры Outlook в Интернете. При включении приложения в списке установленных приложений пользователи могут использовать функции этого приложения в своей электронной почте. Пользователям не заблокирована возможность устанавливать собственные копии этого приложения, включая, но не ограничиваясь пользователями, имеющими разрешение на установку приложений.
  • SpecificUsers: это приложение предоставляется только пользователям, указанным в параметре UserList. Оно также не активируется в элементах их почты или календаря. Для указанных пользователей заблокирована возможность установки собственных экземпляров этого приложения. Неуказанные пользователи могут устанавливать собственные экземпляры этого приложения.

Этот параметр можно использовать вместе с параметром OrganizationApp.

Type:ClientExtensionProvidedTo
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-UserList

Параметр UserList указывает, кто может использовать приложение организации. Этот параметр ограничен 1000 пользователями. В облачной службе это значение менее актуально, так как управление надстройками Office переходит на централизованное развертывание.

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

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Домен\Имя пользователя
  • Адрес электронной почты
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Идентификатор пользователя или имя участника-пользователя

Update Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN". Максимальный размер списка — 1000 получателей.

Этот параметр можно использовать вместе с параметром OrganizationApp.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-WhatIf

Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.