Share via

New-CMApplicationGroup

  • 參考
模組:
ConfigurationManager

建立新的應用程式群組。

Syntax

New-CMApplicationGroup
   [-Name] <String>
   -AddApplication <String[]>
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-AddSupportContact <String[]>]
   [-AppGroupCatalog <AppDisplayInfo[]>]
   [-DefaultLanguageId <Int32>]
   [-LocalizedName <String>]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

使用此 Cmdlet 來建立應用程式群組。 使用應用程式群組，將多個應用程式部署為單一部署的集合。 您為應用程式群組指定的中繼資料是在軟體中心中看作單一實體。 您可以定購群組中的應用程式，讓用戶端依特定順序安裝這些應用程式。 如需詳細資訊，請參閱 Create application groups。

當您建立應用程式群組時，有部分設定無法設定。 若要設定其他設定，請使用 CMApplicationGroup Cmdlet。

注意

從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet，例如 PS XYZ:\> 。 如需詳細資訊，請參閱 快速入門。

範例

範例1：建立含有兩個應用程式的群組

此範例會建立名為 Central app 的新應用程式群組，其中包含兩個應用程式。

$apps = @('LOB Framework','CA UI')

New-CMApplicationGroup -Name 'Central app' -AddApplication $apps -Description 'Central app group' -Publisher 'Contoso IT' -SoftwareVersion '1.1.2' -ReleaseDate (Get-Date) -AddOwner 'jqpublic' -AddSupportContact 'jdoe' -LocalizedAppGroupName 'Central app'

參數

-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

-AppGroupCatalog

使用此參數可指定特定語言的軟體中心專案。 此專案可以包含有關應用程式群組的所有當地語系化資訊：

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

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

Type:AppDisplayInfo[]
Aliases:AppCatalogs
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

-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

-OptionalReference

指定選用字串，以協助您尋找主控台中的應用程式群組。 最大長度為 256 個字元。

Type:String
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

-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

-名稱

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

Type:String
Aliases:LocalizedDisplayName, ApplicationGroupName
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

輸入

無

輸出

IResultObject

備註

此 Cmdlet 會傳回 SMS_ApplicationGroup WMI 類別物件。