共用方式為


Set-CMApplication

設定應用程式的屬性。

語法

Set-CMApplication
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-AddAppCategory <IResultObject[]>]
   [-AddOwner <String[]>]
   [-AddSupportContact <String[]>]
   [-AddUserCategory <IResultObject[]>]
   [-AppCategory <String[]>]
   [-ApplyToLanguageById <Int32>]
   [-AutoInstall <Boolean>]
   [-CleanAppCategory]
   [-CleanUserCategory]
   [-ClearAppCatalog]
   [-ClearOwner]
   [-ClearSupportContact]
   [-DefaultLanguageId <Int32>]
   [-Description <String>]
   [-DisplaySupersedenceInApplicationCatalog <Boolean>]
   [-DistributionPointSetting <DistributionPointSettingType>]
   [-DistributionPriority <DistributionPriorityType>]
   [-IconLocationFile <String>]
   [-InputObject] <IResultObject>
   [-IsFeatured <Boolean>]
   [-Keyword <String[]>]
   [-LinkText <String>]
   [-LocalizedApplicationName <String>]
   [-LocalizedDescription <String>]
   [-NewName <String>]
   [-OptionalReference <String>]
   [-Owner <String>]
   [-PassThru]
   [-PrivacyUrl <String>]
   [-Publisher <String>]
   [-ReleaseDate <DateTime>]
   [-RemoveAppCatalog <Int32[]>]
   [-RemoveAppCategoryName <String[]>]
   [-RemoveOwner <String[]>]
   [-RemoveSupportContact <String[]>]
   [-RemoveUserCategoryName <String[]>]
   [-SendToProtectedDistributionPoint <Boolean>]
   [-SoftwareVersion <String>]
   [-SupportContact <String>]
   [-UserCategory <String[]>]
   [-UserDocumentation <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMApplication
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-AddAppCategory <IResultObject[]>]
   [-AddOwner <String[]>]
   [-AddSupportContact <String[]>]
   [-AddUserCategory <IResultObject[]>]
   [-AppCategory <String[]>]
   [-ApplyToLanguageById <Int32>]
   [-AutoInstall <Boolean>]
   [-CleanAppCategory]
   [-CleanUserCategory]
   [-ClearAppCatalog]
   [-ClearOwner]
   [-ClearSupportContact]
   [-DefaultLanguageId <Int32>]
   [-Description <String>]
   [-DisplaySupersedenceInApplicationCatalog <Boolean>]
   [-DistributionPointSetting <DistributionPointSettingType>]
   [-DistributionPriority <DistributionPriorityType>]
   [-IconLocationFile <String>]
   [-Id] <Int32>
   [-IsFeatured <Boolean>]
   [-Keyword <String[]>]
   [-LinkText <String>]
   [-LocalizedApplicationName <String>]
   [-LocalizedDescription <String>]
   [-NewName <String>]
   [-OptionalReference <String>]
   [-Owner <String>]
   [-PassThru]
   [-PrivacyUrl <String>]
   [-Publisher <String>]
   [-ReleaseDate <DateTime>]
   [-RemoveAppCatalog <Int32[]>]
   [-RemoveAppCategoryName <String[]>]
   [-RemoveOwner <String[]>]
   [-RemoveSupportContact <String[]>]
   [-RemoveUserCategoryName <String[]>]
   [-SendToProtectedDistributionPoint <Boolean>]
   [-SoftwareVersion <String>]
   [-SupportContact <String>]
   [-UserCategory <String[]>]
   [-UserDocumentation <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMApplication
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-AddAppCategory <IResultObject[]>]
   [-AddOwner <String[]>]
   [-AddSupportContact <String[]>]
   [-AddUserCategory <IResultObject[]>]
   [-AppCategory <String[]>]
   [-ApplyToLanguageById <Int32>]
   [-AutoInstall <Boolean>]
   [-CleanAppCategory]
   [-CleanUserCategory]
   [-ClearAppCatalog]
   [-ClearOwner]
   [-ClearSupportContact]
   [-DefaultLanguageId <Int32>]
   [-Description <String>]
   [-DisplaySupersedenceInApplicationCatalog <Boolean>]
   [-DistributionPointSetting <DistributionPointSettingType>]
   [-DistributionPriority <DistributionPriorityType>]
   [-IconLocationFile <String>]
   [-IsFeatured <Boolean>]
   [-Keyword <String[]>]
   [-LinkText <String>]
   [-LocalizedApplicationName <String>]
   [-LocalizedDescription <String>]
   -ModelName <String>
   [-NewName <String>]
   [-OptionalReference <String>]
   [-Owner <String>]
   [-PassThru]
   [-PrivacyUrl <String>]
   [-Publisher <String>]
   [-ReleaseDate <DateTime>]
   [-RemoveAppCatalog <Int32[]>]
   [-RemoveAppCategoryName <String[]>]
   [-RemoveOwner <String[]>]
   [-RemoveSupportContact <String[]>]
   [-RemoveUserCategoryName <String[]>]
   [-SendToProtectedDistributionPoint <Boolean>]
   [-SoftwareVersion <String>]
   [-SupportContact <String>]
   [-UserCategory <String[]>]
   [-UserDocumentation <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMApplication
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-AddAppCategory <IResultObject[]>]
   [-AddOwner <String[]>]
   [-AddSupportContact <String[]>]
   [-AddUserCategory <IResultObject[]>]
   [-AppCategory <String[]>]
   [-ApplyToLanguageById <Int32>]
   [-AutoInstall <Boolean>]
   [-CleanAppCategory]
   [-CleanUserCategory]
   [-ClearAppCatalog]
   [-ClearOwner]
   [-ClearSupportContact]
   [-DefaultLanguageId <Int32>]
   [-Description <String>]
   [-DisplaySupersedenceInApplicationCatalog <Boolean>]
   [-DistributionPointSetting <DistributionPointSettingType>]
   [-DistributionPriority <DistributionPriorityType>]
   [-IconLocationFile <String>]
   [-IsFeatured <Boolean>]
   [-Keyword <String[]>]
   [-LinkText <String>]
   [-LocalizedApplicationName <String>]
   [-LocalizedDescription <String>]
   [-Name] <String>
   [-NewName <String>]
   [-OptionalReference <String>]
   [-Owner <String>]
   [-PassThru]
   [-PrivacyUrl <String>]
   [-Publisher <String>]
   [-ReleaseDate <DateTime>]
   [-RemoveAppCatalog <Int32[]>]
   [-RemoveAppCategoryName <String[]>]
   [-RemoveOwner <String[]>]
   [-RemoveSupportContact <String[]>]
   [-RemoveUserCategoryName <String[]>]
   [-SendToProtectedDistributionPoint <Boolean>]
   [-SoftwareVersion <String>]
   [-SupportContact <String>]
   [-UserCategory <String[]>]
   [-UserDocumentation <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

使用 Set-CMApplication Cmdlet 來設定應用程式的設定。

注意事項

從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet,例如 PS XYZ:\>。 如需詳細資訊,請 參閱開始使用

範例

範例 1:重新設定應用程式的屬性

第一個命令會取得名為 Application01的應用程式物件。 接下來的兩個命令會使用 Get-CMCategory Cmdlet 來取得使用者和系統管理員類別的物件。 Set-CMApplication Cmdlet 接著會在 Applicaton01 上設定指定的屬性。

$app = Get-CMApplication -Name "Application01"
$userCat = Get-CMCategory -Name "Test Applications" -CategoryType CatalogCategories
$adminCat = Get-CMCategory -Name "Testing" -CategoryType AppCategories

Set-CMApplication -InputObject $app -NewName "Application01_New" -Description "Application updated" -Publisher "Test group" -SoftwareVersion "1.0.0.1" -OptionalReference "Reference" -ReleaseDate 2/24/2016 -AutoInstall $True -Owner "jqpublic" -SupportContact "jqpublic" -LocalizedApplicationName "Localized Application01" -UserDocumentation "https://contoso.com/content" -LinkText "For more info" -LocalizedDescription "Localized Application New" -Keyword "Application" -PrivacyUrl "https://contoso.com/privacy" -IsFeatured $True -IconLocationFile "C:\Users\art\icon.png" -DistributionPriority Medium -SendToProtectedDistributionPoint $True -DistributionPointSetting NoDownload -AddUserCategory $userCat -AddAppCategory $adminCat

參數

-AddAppCatalog

使用此參數來指定特定語言的軟體中心專案。 這個項目可以包含應用程式的所有本地化資訊:

  • 描述
  • IconLocationFile
  • 關鍵字
  • LinkText
  • PrivacyUrl
  • 標題
  • UserDocumentation

若要取得此物件,請使用 New-CMApplicationDisplayInfo Cmdlet。

類型:AppDisplayInfo[]
別名:AppCatalogs
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-AddAppCategory

指定一或多個系統管理類別物件,以協助您在控制台中篩選和尋找應用程式。 若要取得這些物件,請使用 Get-CMCategory Cmdlet。 這些類別屬於 AppCategories類型。

若要新增類別以協助使用者在軟體中心篩選和尋找應用程式,請使用 AddUserCategory 參數。

類型:IResultObject[]
別名:AddAppCategories
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-AddOwner

指定負責此應用程式的一或多個系統管理使用者。

類型:String[]
別名:AddOwners
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-AddSupportContact

指定使用者可以連絡的一或多個系統管理使用者,以取得此應用程式的協助。

類型:String[]
別名:AddSupportContacts
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-AddUserCategory

指定一或多個使用者類別物件,以協助您在控制台中篩選和尋找應用程式群組。 若要取得這些物件,請使用 Get-CMCategory Cmdlet。 這些類別屬於 CatalogCategories 類型。

若要新增類別以協助使用者在軟體中心篩選和尋找應用程式,請使用 AddAppCategory 參數。

類型:IResultObject[]
別名:AddUserCategories
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-AppCategory

此參數已被取代,請使用 -AddAppCategory

類型:String[]
別名:AppCategories
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ApplyToLanguageById

對於顯示在軟體中心的設定,請使用此參數來指定設定的語言標識碼。

此標識子是 Windows 語言識別子的小數對等專案。 例如, 10330x0409 適用於 英文 (美國) ,而 21080x083C 適用於 愛爾蘭 () 。 如需詳細資訊,請參閱 [MS-LCID]: Windows 語言代碼識別碼 (LCID) 參考。

例如,若要為 愛爾蘭 (愛爾蘭 新增本地化應用程式名稱) :

-ApplyToLanguageById 2108 -LocalizedName "Fáilte romhat"

類型:Int32
別名:ApplySettingToSpecificLanguage
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-AutoInstall

將此參數設定 為 $true ,以允許從 [安裝應用程式] 工作順序步驟安裝應用程式,而不需要部署。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-CleanAppCategory

新增此參數以移除所有系統管理類別。 若要移除單一類別,請使用 RemoveAppCategory 參數。

類型:SwitchParameter
別名:CleanAppCategories
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-CleanUserCategory

新增此參數以移除所有用戶類別。 若要移除單一類別,請使用 RemoveUserCategory 參數。

類型:SwitchParameter
別名:CleanUserCategories
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ClearAppCatalog

新增此參數以移除所有本地化的軟體中心專案。 若要移除單一專案,請使用 RemoveAppCatalog 參數。

類型:SwitchParameter
別名:ClearAppCatalogs, CleanAppCatalog, CleanAppCatalogs
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ClearOwner

新增此參數以移除所有擁有者。 若要移除單一擁有者,請使用 RemoveOwner 參數。

類型:SwitchParameter
別名:CleanOwners
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ClearSupportContact

新增此參數以移除所有支持聯繫人。 若要移除單一聯繫人,請使用 RemoveSupportContact 參數。

類型:SwitchParameter
別名:CleanSupportContacts
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Confirm

執行 Cmdlet 之前提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-DefaultLanguageId

指定預設軟體中心語言的語言標識碼。

此標識子是 Windows 語言識別子的小數對等專案。 例如, 10330x0409 適用於 英文 (美國) ,而 21080x083C 適用於 愛爾蘭 () 。 如需詳細資訊,請參閱 [MS-LCID]: Windows 語言代碼識別碼 (LCID) 參考。

類型:Int32
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Description

指定應用程式的選擇性系統管理員批注。 最大長度為 2048 個字元。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DisableWildcardHandling

此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DisplaySupersedenceInApplicationCatalog

雖然不再支援應用程式類別目錄,但您仍然可以使用此參數來允許使用者在此應用程式及其取代的所有應用程式的軟體中心部署中看到。

類型:Boolean
別名:DisplaySupersedencesInApplicationCatalog
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DistributionPointSetting

指定預先設定的發佈點設定:

  • AutoDownload:將套件指派給發佈點時自動下載內容。

  • DeltaCopy:僅下載發佈點的內容變更。

  • NoDownload:手動將此套件中的內容複製到發佈點。

類型:DistributionPointSettingType
接受的值:AutoDownload, DeltaCopy, NoDownload
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DistributionPriority

指定網站將內容傳送至此網站中其他網站和發佈點的順序。

網站會先傳送高優先順序的內容,再傳送中低優先順序的內容。 優先順序相等的內容會依其建立順序傳送。

類型:DistributionPriorityType
接受的值:High, Medium, Low
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ForceWildcardHandling

此參數會處理通配符,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-IconLocationFile

指定包含此應用程式圖示的檔案路徑。 圖示可以有最多 512x512 的像素維度。 檔案可以是下列影像和圖示檔案類型:

  • DLL
  • EXE
  • JPG
  • ICO
  • PNG
類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Id

指定要設定之應用程式的識別碼。 這個值與 CI_ID相同,例如 1025866

類型:Int32
別名:CIId, CI_ID
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-InputObject

指定要設定的應用程式物件。 若要取得此物件,請使用 Get-CMApplication Cmdlet。

類型:IResultObject
別名:Application
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-IsFeatured

將此參數設定為 $true ,以將此應用程式顯示為精選應用程式,並在公司入口網站中反白顯示。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Keyword

以選取的語言指定關鍵詞清單。 這些關鍵詞可協助軟體中心用戶搜尋應用程式群組。

提示

若要新增多個關鍵詞,請使用 CultureInfo.CurrentCulture.TextInfo.ListSeparator 作為分隔符。

類型:String[]
別名:Keywords
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-LinkText

當您使用 UserDocumentation 參數時,請使用此參數來顯示字串,以取代軟體中心的「其他資訊」。 最大長度為 128 個字元。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-LocalizedApplicationName

以選取的語言指定應用程式名稱。 此名稱會出現在軟體中心。

您新增的每個語言都需要名稱。

最大長度為 256 個字元。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-LocalizedDescription

以選取的語言指定此應用程式的描述。 最大長度為 2048 個字元。

類型:String
別名:LocalizedApplicationDescription
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ModelName

指定要設定之應用程式的應用程式模型標識碼。 此值也稱為 CI 唯一識別碼。 例如,ScopeId_0D7D8B60-F2F9-484A-B9F3-4A8B68D14D59/ApplicationGroup_047fbf05-55f4-42ab-9581-e63fd0337fed

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Name

指定要設定的應用程式名稱。

類型:String
別名:LocalizedDisplayName, ApplicationName
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-NewName

使用此參數來重新命名應用程式。 最大長度為 256 個字元。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-OptionalReference

指定選擇性字串,以協助您在控制台中尋找應用程式。 最大長度為 256 個字元。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Owner

指定負責此應用程式的系統管理使用者。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-PassThru

新增此參數以傳回 物件,代表您正在使用的專案。 根據預設,此 Cmdlet 可能不會產生任何輸出。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-PrivacyUrl

指定應用程式隱私聲明的網站位址。 格式必須是有效的 URL,例如 https://contoso.com/privacy。 整個字串的最大長度為 128 個字元。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Publisher

指定此應用程式的選擇性廠商資訊。 最大長度為 256 個字元。

類型:String
別名:Manufacturer
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ReleaseDate

指定此應用程式發行時間的日期物件。 若要取得此物件,請使用 Get-Date 內建 Cmdlet。

類型:DateTime
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RemoveAppCatalog

指定語言識別碼的陣列,以移除相關聯的軟體中心專案。 若要移除所有專案,請使用 ClearAppCatalog 參數。

此標識子是 Windows 語言識別子的小數對等專案。 例如, 10330x0409 適用於 英文 (美國) ,而 21080x083C 適用於 愛爾蘭 () 。 如需詳細資訊,請參閱 [MS-LCID]: Windows 語言代碼識別碼 (LCID) 參考。

例如,若要移除 愛爾蘭 (愛爾蘭的 當地語系化軟體中心專案) :

-RemoveAppCatalog 2108

類型:Int32[]
別名:RemoveAppCatalogsByLanguageId
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RemoveAppCategoryName

指定要移除的系統管理類別目錄名稱陣列。 若要移除所有系統管理類別,請使用 CleanAppCategory 參數。

類型:String[]
別名:RemoveAppCategoryNames
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RemoveOwner

指定要移除的擁有者陣列。 若要移除所有擁有者,請使用 ClearOwner 參數。

類型:String[]
別名:RemoveOwners
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RemoveSupportContact

指定要移除的支持聯繫人數組。 若要移除所有支持聯繫人,請使用 ClearSupportContact 參數。

類型:String[]
別名:RemoveSupportContacts
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RemoveUserCategoryName

指定要移除的使用者類別目錄名稱陣列。 若要移除所有用戶類別,請使用 CleanUserCategory 參數。

類型:String[]
別名:RemoveUserCategoryNames
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SendToProtectedDistributionPoint

指出是否要將此應用程式複製到受保護的發佈點。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SoftwareVersion

指定應用程式的選擇性版本字串。 最大長度為 64 個字元。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SupportContact

指定使用者可以連絡的系統管理使用者,以取得此應用程式的協助。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-UserCategory

此參數已被取代,請使用 -AddUserCategory

類型:String[]
別名:UserCategories
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-UserDocumentation

指定檔案的位置,讓軟體中心使用者可以從中取得此應用程式的詳細資訊。 此位置是網站位址,或網路路徑和檔名。 請確定使用者可以存取此位置。

整個字串的最大長度為 256 個字元。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

IResultObject

備註

如需這個傳回物件及其屬性的詳細資訊,請 參閱SMS_Application伺服器 WMI 類別