Set-App

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。

使用 Set-App Cmdlet 來修改組織應用程式的可用性。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法

Syntax

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

Description

Set-App Cmdlet 只能在設定組織應用程式的可用性時使用。 此工作需要已安裝指定的應用程式 (例如,應用程式已與 New-App Cmdlet 一起安裝,或是它是 Outlook) 的預設應用程式。

Outlook 網頁版中的預設應用程式,以及您已安裝供組織中使用者使用的應用程式,稱為組織應用程式。 使用者無法移除組織應用程式,但可以進行啟用或停用。 若應用程式為組織應用程式(預設或組織),會為使用者停用工具列的刪除控制。 管理員可移除組織應用程式。 管理員不能移除預設應用程式,但可停用整個組織的應用程式。

如需詳細資訊,請參閱在 Exchange Server 中管理 Outlook 載入宏的使用者存取權和在Microsoft 365 系統管理中心中管理增益集的部署

您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 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 的組織應用程式變更為提供給財務小組群組的成員,並預設為啟用。

範例 2

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

此範例會停用整個組織中名為 FinanceTestApp 的組織應用程式,並將其從使用者檢視中隱藏。

參數

-Confirm

Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。

  • 例如,具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停,可強制您在繼續之前確認命令。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:-Confirm:$false
  • 其他大部分的 Cmdlet (例如,New-* 和 Set-* Cmdlet) 沒有內建暫停。 在使用這些 Cmdlet 時,指定不含任何值的 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 參數會為指定的使用者指定組織應用程式的預設初始狀態。 有效值為:

  • 已啟用:已啟用組織應用程式。
  • 已停用:已停用組織應用程式。 這是預設值。
  • 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 參數會指定此 Cmdlet 用來向 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)
  • Domain\Username
  • 電子郵件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 使用者識別碼或使用者主要名稱 (UPN)

您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號,請使用下列語法: "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

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。