Set-CMApplicationGroup
設定現有的應用程式群組。
Syntax
Set-CMApplicationGroup
[-InputObject] <IResultObject>
[-NewName <String>]
[-Description <String>]
[-Publisher <String>]
[-SoftwareVersion <String>]
[-OptionalReference <String>]
[-AddAppCategory <IResultObject[]>]
[-RemoveAppCategoryName <String[]>]
[-CleanAppCategory]
[-ReleaseDate <DateTime>]
[-AddOwner <String[]>]
[-RemoveOwner <String[]>]
[-ClearOwner]
[-AddSupportContact <String[]>]
[-RemoveSupportContact <String[]>]
[-ClearSupportContact]
[-AddAppCatalog <AppDisplayInfo[]>]
[-RemoveAppCatalog <Int32[]>]
[-ClearAppCatalog]
[-DefaultLanguageId <Int32>]
[-ApplyToLanguageById <Int32>]
[-LocalizedName <String>]
[-AddUserCategory <IResultObject[]>]
[-RemoveUserCategoryName <String[]>]
[-CleanUserCategory]
[-UserDocumentation <String>]
[-LinkText <String>]
[-PrivacyUrl <String>]
[-LocalizedDescription <String>]
[-Keyword <String[]>]
[-IconLocationFile <String>]
[-AddApplication <String[]>]
[-RemoveApplication <String[]>]
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMApplicationGroup
[-Id] <Int32>
[-NewName <String>]
[-Description <String>]
[-Publisher <String>]
[-SoftwareVersion <String>]
[-OptionalReference <String>]
[-AddAppCategory <IResultObject[]>]
[-RemoveAppCategoryName <String[]>]
[-CleanAppCategory]
[-ReleaseDate <DateTime>]
[-AddOwner <String[]>]
[-RemoveOwner <String[]>]
[-ClearOwner]
[-AddSupportContact <String[]>]
[-RemoveSupportContact <String[]>]
[-ClearSupportContact]
[-AddAppCatalog <AppDisplayInfo[]>]
[-RemoveAppCatalog <Int32[]>]
[-ClearAppCatalog]
[-DefaultLanguageId <Int32>]
[-ApplyToLanguageById <Int32>]
[-LocalizedName <String>]
[-AddUserCategory <IResultObject[]>]
[-RemoveUserCategoryName <String[]>]
[-CleanUserCategory]
[-UserDocumentation <String>]
[-LinkText <String>]
[-PrivacyUrl <String>]
[-LocalizedDescription <String>]
[-Keyword <String[]>]
[-IconLocationFile <String>]
[-AddApplication <String[]>]
[-RemoveApplication <String[]>]
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMApplicationGroup
-ModelName <String>
[-NewName <String>]
[-Description <String>]
[-Publisher <String>]
[-SoftwareVersion <String>]
[-OptionalReference <String>]
[-AddAppCategory <IResultObject[]>]
[-RemoveAppCategoryName <String[]>]
[-CleanAppCategory]
[-ReleaseDate <DateTime>]
[-AddOwner <String[]>]
[-RemoveOwner <String[]>]
[-ClearOwner]
[-AddSupportContact <String[]>]
[-RemoveSupportContact <String[]>]
[-ClearSupportContact]
[-AddAppCatalog <AppDisplayInfo[]>]
[-RemoveAppCatalog <Int32[]>]
[-ClearAppCatalog]
[-DefaultLanguageId <Int32>]
[-ApplyToLanguageById <Int32>]
[-LocalizedName <String>]
[-AddUserCategory <IResultObject[]>]
[-RemoveUserCategoryName <String[]>]
[-CleanUserCategory]
[-UserDocumentation <String>]
[-LinkText <String>]
[-PrivacyUrl <String>]
[-LocalizedDescription <String>]
[-Keyword <String[]>]
[-IconLocationFile <String>]
[-AddApplication <String[]>]
[-RemoveApplication <String[]>]
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMApplicationGroup
[-Name] <String>
[-NewName <String>]
[-Description <String>]
[-Publisher <String>]
[-SoftwareVersion <String>]
[-OptionalReference <String>]
[-AddAppCategory <IResultObject[]>]
[-RemoveAppCategoryName <String[]>]
[-CleanAppCategory]
[-ReleaseDate <DateTime>]
[-AddOwner <String[]>]
[-RemoveOwner <String[]>]
[-ClearOwner]
[-AddSupportContact <String[]>]
[-RemoveSupportContact <String[]>]
[-ClearSupportContact]
[-AddAppCatalog <AppDisplayInfo[]>]
[-RemoveAppCatalog <Int32[]>]
[-ClearAppCatalog]
[-DefaultLanguageId <Int32>]
[-ApplyToLanguageById <Int32>]
[-LocalizedName <String>]
[-AddUserCategory <IResultObject[]>]
[-RemoveUserCategoryName <String[]>]
[-CleanUserCategory]
[-UserDocumentation <String>]
[-LinkText <String>]
[-PrivacyUrl <String>]
[-LocalizedDescription <String>]
[-Keyword <String[]>]
[-IconLocationFile <String>]
[-AddApplication <String[]>]
[-RemoveApplication <String[]>]
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
使用此 Cmdlet 可設定現有應用程式群組的設定。 使用應用程式群組,將多個應用程式部署至集合,做為單一部署。 您為應用程式群組指定的中繼資料是在軟體中心中看作單一實體。 您可以定購群組中的應用程式,讓用戶端依特定順序安裝這些應用程式。 如需詳細資訊,請參閱 Create application groups。
注意
從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請參閱 快速入門。
範例
範例1:重新命名應用程式群組
此範例會取得應用程式群組的物件,並將它傳遞至此 Cmdlet 以重新命名該物件。
$appgroup = Get-CMApplicationGroup -Name "Central app"
Set-CMApplicationGroup -InputObject $appgroup -NewName "Contoso Central App"
範例2:新增當地語系化名稱
此範例會使用 愛爾蘭 文的當地語系化應用程式名稱來設定應用程式群組。
Set-CMApplicationGroup -Name "Contoso Welcome app" -ApplyToLanguageById 60 -LocalizedName "Fáilte romhat"
參數
-AddAppCatalog
使用此參數可指定特定語言的軟體中心專案。 此專案可以包含有關應用程式群組的所有當地語系化資訊:
- 描述
- IconLocationFile
- 關鍵字
- LinkText
- PrivacyUrl
- 標題
- UserDocumentation
若要取得此物件,請使用 CMApplicationDisplayInfo Cmdlet。
Type: | AppDisplayInfo[] |
Aliases: | AppCatalogs |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddAppCategory
指定一或多個管理類別物件,以協助您篩選和尋找主控台中的應用程式群組。 若要取得這些物件,請使用 CMCategory Cmdlet。 這些類別的類型為 AppCategories。
若要新增類別以協助使用者在軟體中心中篩選和尋找應用程式,請使用 AddUserCategory 參數。
Type: | IResultObject[] |
Aliases: | AddAppCategories |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddApplication
指定要新增至群組的應用程式名稱字串陣列。 如果您已經有來自其他 Cmdlet (如 CMApplication)的應用程式物件,這個值就是 LocalizedDisplayName 屬性。 例如:$appList = @($app1.LocalizedDisplayName,$app2.LocalizedDisplayName)
Type: | String[] |
Aliases: | AddApplications |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddOwner
指定一或多個負責此應用程式群組的管理使用者。
Type: | String[] |
Aliases: | AddOwners |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddSupportContact
指定一或多個使用者可以聯繫以取得此應用程式之協助的系統管理使用者。
Type: | String[] |
Aliases: | AddSupportContacts |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddUserCategory
指定一或多個使用者類別物件,以協助您篩選和尋找主控台中的應用程式群組。 若要取得這些物件,請使用 CMCategory Cmdlet。 這些類別的類型為 CatalogCategories。
若要新增類別以協助使用者在軟體中心中篩選和尋找應用程式,請使用 AddAppCategory 參數。
Type: | IResultObject[] |
Aliases: | AddUserCategories |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplyToLanguageById
如需在軟體中心顯示的設定,請使用此參數來指定設定的語言識別項。
此 ID 為 Windows 語言識別項的十進位數。 例如,適用 1033
0x0409
于 **英文 (美國) **,且 2108
0x083C
適用于 **愛爾蘭 (愛爾蘭) **。 如需詳細資訊,請參閱[MS-LCID]: Windows 語言代碼識別碼 (LCID) 參照。
例如,若要為 **愛爾蘭 (愛爾蘭) **新增已當地語系化的應用程式名稱:
-ApplyToLanguageById 2108 -LocalizedName "Fáilte romhat"
Type: | Int32 |
Aliases: | ApplySettingToSpecificLanguage |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CleanAppCategory
新增此參數可移除所有管理類別。 若要移除單一類別,請使用 RemoveAppCategory 參數。
Type: | SwitchParameter |
Aliases: | CleanAppCategories |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CleanUserCategory
新增此參數可移除所有使用者類別。 若要移除單一類別,請使用 RemoveUserCategory 參數。
Type: | SwitchParameter |
Aliases: | CleanUserCategories |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClearAppCatalog
新增此參數可移除所有已當地語系化的軟體中心專案。 若要移除單一專案,請使用 RemoveAppCatalog 參數。
Type: | SwitchParameter |
Aliases: | ClearAppCatalogs, CleanAppCatalog, CleanAppCatalogs |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClearOwner
新增此參數可移除所有擁有者。 若要移除單一擁有者,請使用 RemoveOwner 參數。
Type: | SwitchParameter |
Aliases: | CleanOwners |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClearSupportContact
新增此參數可移除所有支援連絡人。 若要移除單一連絡人,請使用 RemoveSupportContact 參數。
Type: | SwitchParameter |
Aliases: | CleanSupportContacts |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultLanguageId
指定預設軟體中心語言的語言識別項。
此 ID 為 Windows 語言識別項的十進位數。 例如,適用 1033
0x0409
于 **英文 (美國) **,且 2108
0x083C
適用于 **愛爾蘭 (愛爾蘭) **。 如需詳細資訊,請參閱[MS-LCID]: Windows 語言代碼識別碼 (LCID) 參照。
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
指定應用程式群組的選擇性管理員批註。 最大長度為 2048 個字元。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
此參數會將萬用字元視為常值字元值。 您無法將它與 ForceWildcardHandling合併。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
這個參數會處理萬用字元,而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IconLocationFile
指定包含此應用程式群組之圖示的檔案名路徑。 圖示可具有最多512x512 的圖元尺寸。 該檔案可以是下列 image 和 icon 檔案類型:
- DLL
- EXE
- JPG
- .ICO
- PNG
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
指定要設定的應用程式群組物件。 若要取得此物件,請使用 CMApplicationGroup Cmdlet。
Type: | IResultObject |
Aliases: | ApplicationGroup |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LinkText
當您使用 UserDocumentation 參數時,請使用此參數來顯示 string Center 中的「其他資訊」的字串。 最大長度為 128 個字元。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LocalizedDescription
指定此應用程式群組的描述(選取語言)。 最大長度為 2048 個字元。
Type: | String |
Aliases: | LocalizedAppGroupDescription |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LocalizedName
指定所選語言的應用程式組名稱。 此名稱會出現在 [軟體中心]。
您新增的每一種語言都必須有名稱。
最大長度為 256 個字元。
Type: | String |
Aliases: | LocalizedAppGroupName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ModelName
指定要設定之應用程式群組的應用程式模型識別碼。 這個值也稱為 CI 唯一識別碼。 例如,ScopeId_0D7D8B60-F2F9-484A-B9F3-4A8B68D14D59/ApplicationGroup_047fbf05-55f4-42ab-9581-e63fd0337fed
。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewName
使用此參數可重新命名應用程式群組。 最大長度為 256 個字元。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OptionalReference
指定選用字串,以協助您尋找主控台中的應用程式群組。 最大長度為 256 個字元。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
新增此參數可傳回代表您正在使用之專案的物件。 根據預設,此 Cmdlet 可能不會產生任何輸出。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrivacyUrl
指定應用程式群組之隱私權聲明的網站位址。 例如,格式必須是有效的 URL https://contoso.com/privacy
。 整個字串的長度上限為128個字元。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Publisher
指定此應用程式群組的選用廠商資訊。 最大長度為 256 個字元。
Type: | String |
Aliases: | Manufacturer |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReleaseDate
指定此應用程式群組的發行日期物件。 若要取得此物件,請使用 Get-Date 內建 Cmdlet。
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveAppCatalog
指定語言識別碼s 的陣列,以移除相關聯的軟體中心專案。 若要移除所有專案,請使用 ClearAppCatalog 參數。
此 ID 為 Windows 語言識別項的十進位數。 例如,適用 1033
0x0409
于 **英文 (美國) **,且 2108
0x083C
適用于 **愛爾蘭 (愛爾蘭) **。 如需詳細資訊,請參閱[MS-LCID]: Windows 語言代碼識別碼 (LCID) 參照。
例如,若要移除 **愛爾蘭 (愛爾蘭) **的當地語系化軟體中心專案:
-RemoveAppCatalog 2108
Type: | Int32[] |
Aliases: | RemoveAppCatalogsByLanguageId |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveAppCategoryName
指定要移除的管理類別名稱陣列。 若要移除所有的管理類別,請使用 CleanAppCategory 參數。
Type: | String[] |
Aliases: | RemoveAppCategoryNames |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveApplication
指定要從此群組中移除的應用程式名稱陣列。
Type: | String[] |
Aliases: | RemoveApplications |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveOwner
指定要移除的擁有者陣列。 若要移除所有擁有者,請使用 ClearOwner 參數。
Type: | String[] |
Aliases: | RemoveOwners |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveSupportContact
指定要移除的支援連絡人陣列。 若要移除所有支援連絡人,請使用 ClearSupportContact 參數。
Type: | String[] |
Aliases: | RemoveSupportContacts |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveUserCategoryName
指定要移除的使用者類別名稱陣列。 若要移除所有使用者類別,請使用 CleanUserCategory 參數。
Type: | String[] |
Aliases: | RemoveUserCategoryNames |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareVersion
指定應用程式群組的選用版本字串。 最大長度為 64 個字元。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserDocumentation
指定檔案的位置,軟體中心使用者可以從該檔案取得此應用程式群組的詳細資訊。 此位置是網站位址,或網路路徑和檔案名。 請確定使用者有權存取此位置。
整個字串的長度上限為256個字元。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 不會執行 Cmdlet。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-名稱
指定要設定的應用程式群組名稱。
Type: | String |
Aliases: | LocalizedDisplayName, ApplicationGroupName |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-識別碼
指定要設定之應用程式群組的識別碼。 例如,此值與 CI_ID相同 1025866
。
Type: | Int32 |
Aliases: | CIId, CI_ID |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-關鍵字
指定所選取語言的關鍵字清單。 這些關鍵字可協助軟體中心使用者搜尋應用程式群組。
提示
若要新增多個關鍵字,請使用 CultureInfo ListSeparator TextInfo 做為分隔符號。
Type: | String[] |
Aliases: | Keywords |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
ConfigurationManagement IResultObject
輸出
IResultObject
此 Cmdlet 會傳回 SMS_ApplicationGroup WMI 類別物件。