New-CMApplication

  • 參考
模組:
ConfigurationManager

建立應用程式。

語法

New-CMApplication
   [-AddOwner <String[]>]
   [-AddSupportContact <String[]>]
   [-AppCatalog <AppDisplayInfo[]>]
   [-AutoInstall <Boolean>]
   [-DefaultLanguageId <Int32>]
   [-Description <String>]
   [-DisplaySupersedenceInApplicationCatalog <Boolean>]
   [-IconLocationFile <String>]
   [-IsFeatured <Boolean>]
   [-Keyword <String[]>]
   [-LinkText <String>]
   [-LocalizedDescription <String>]
   [-LocalizedName <String>]
   [-Name] <String>
   [-OptionalReference <String>]
   [-Owner <String>]
   [-PrivacyUrl <String>]
   [-Publisher <String>]
   [-ReleaseDate <DateTime>]
   [-SoftwareVersion <String>]
   [-SupportContact <String>]
   [-UserDocumentation <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

使用此 Cmdlet 建立應用程式。 Configuration Manager 應用程式會定義應用程式的相關元數據。 如需詳細資訊，請 參閱在 Configuration Manager 中建立應用程式。

注意事項

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

範例

範例 1：建立應用程式

此命令會建立名為Application01的應用程式。

New-CMApplication -Name "Application01" -Description "New Application" -Publisher "Contoso" -SoftwareVersion "1.0.0.1" -OptionalReference "Reference" -ReleaseDate 2/24/2016 -AutoInstall $True -Owner "Administrator" -SupportContact "Administrator" -LocalizedName "Application01" -UserDocumentation "https://contoso.com/content" -LinkText "For more information" -LocalizedDescription "New Localized Application" -Keyword "application" -PrivacyUrl "https://contoso.com/library/privacy" -IsFeatured $True -IconLocationFile "\\central\icons\icon.png"

參數

-AddOwner

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

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

-AddSupportContact

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

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

-AppCatalog

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

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

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

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

-AutoInstall

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

類型:Boolean
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

-ForceWildcardHandling

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

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

-IconLocationFile

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

  • DLL
  • EXE
  • JPG
  • ICO
  • PNG
類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元: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

-LocalizedDescription

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

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

-LocalizedName

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

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

最大長度為 256 個字元。

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

-Name

指定應用程式的名稱。 最大長度為 256 個字元。

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

-OptionalReference

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

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

-Owner

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

類型:String
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

-SoftwareVersion

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

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

-SupportContact

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

類型:String
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

輸入

None

輸出

IResultObject

IResultObject

備註

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