Set-App
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能僅限於一個環境或另一個環境。
使用 Set-App Cmdlet 來修改組織應用程式的可用性。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
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 的所有參數，但如果指派給您的權限中未包含某些參數，您可能無法存取這些參數。 若要尋找在組織中執行任何 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
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署信箱的內建安全性附加元件
Confirm 參數會指定要顯示或隱藏確認提示。 此參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續。
- 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：
-Confirm:$false。 - 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 針對這些 Cmdlet，指定不帶值的 Confirm 參數會造成暫停，強制您在繼續之前先確認命令。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | CF |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DefaultStateForUser
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
DefaultStateForUser 參數會為指定的使用者指定組織應用程式的預設初始狀態。 有效值為：
- 已啟用：組織應用程式已啟用。
- 已停用：組織應用程式已停用。 此值為預設值。
- AlwaysEnabled：組織應用程式已啟用，且使用者無法停用它。
您會將此參數與 OrganizationApp 參數搭配使用。
參數屬性
| 類型: | DefaultStateForUser |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DomainController
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Enabled
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Enabled 參數會指定組織中的使用者的應用程式是否可用。 有效值為：
- $true：已針對指定的使用者啟用應用程式。 此值為預設值。
- $false：組織中的任何使用者都未啟用該應用程式。 這將在所有使用者的使用者檢視中隱藏應用程式。
此設定會覆寫 ProvidedTo，UserList，和 DefaultStateForUser 設定。 若使用者擁有安裝權限，此設定無法讓使用者不能自行安裝應用程式的執行個體。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署信箱的內建安全性附加元件
Identity 參數會指定您要修改之應用程式的 AppID (GUID 值) 。 若要尋找應用程式的 GUID 值，請執行 Get-App | Format-Table -Auto DisplayName,AppId 命令。
參數屬性
| 類型: | AppIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-OrganizationApp
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
OrganizationApp 參數會指定應用程式的範圍為組織 (不受限於特定使用者)。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PrivateCatalog
適用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
PrivateCatalog 參數會指定您要修改的應用程式位於私用類別中。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ProvidedTo
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ProvidedTo 參數會指定您組織中應用程式的可用性。 有效值為：
- 所有人：應用程式會提供給組織中的每個使用者。 此值為預設值。 每個使用者都會看到此應用程式列在 Outlook 網頁版選項的已安裝應用程式清單中。 已安裝應用程式清單中的應用程式為已啟用時，使用者即可在電子郵件中使用此應用程式的功能。 所有使用者皆無法自行安裝此應用程式的執行個體，包括但不限於擁有安裝應用程式權限的使用者。
- SpecificUsers：此應用程式僅提供給 UserList 參數指定的使用者。 所有其他使用者不會在他們的管理檢視中看到這個組織應用程式，也不會在其郵件或行事曆項目中啟用。 指定的使用者也會被禁止安裝自己的此應用程式執行個體。 未列出的使用者不會被阻止安裝自己的此應用程式執行個體。
您會將此參數與 OrganizationApp 參數搭配使用。
參數屬性
| 類型: | ClientExtensionProvidedTo |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UserList
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
UserList 參數會指定誰可以使用組織應用程式。 此參數限制為 1000 個使用者。 在雲端式服務中，由於 Office 增益集管理正在移至 集中部署，因此此值較不相關。
有效值為組織中的信箱或郵件使用者。 您可以使用唯一識別使用者的任何值。 例如：
- 名稱
- 別名
- 辨別名稱 (DN)
- 辨別名稱 (DN)
- 網域\使用者名稱
- 電子郵件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 使用者識別碼或使用者主要名稱 (UPN)
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號，請使用下列語法: "Value1","Value2",..."ValueN"。 清單大小上限為 1000 個收件者。
您會將此參數與 OrganizationApp 參數搭配使用。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署信箱的內建安全性附加元件
WhatIf 參數會顯示命令在不進行任何變更的情況下執行的動作。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | WI |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
Input types
若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。