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
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по