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