次の方法で共有

New-CMApplicationGroup

  • リファレンス
モジュール:
ConfigurationManager

新しいアプリケーション グループを作成します。

構文

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>]

説明

このコマンドレットを使用して、アプリケーション グループを作成します。 アプリケーション グループを使用して、複数のアプリケーションを 1 つのデプロイとしてコレクションにデプロイします。 アプリ グループに関して指定したメタデータは、ソフトウェア センターで 1 つのエンティティとして表示されます。 クライアントが特定の順序でアプリをインストールできるように、グループ内のアプリを注文できます。 詳細については、「 アプリケーション グループの作成」を参照してください。

アプリ グループを作成するときに構成できない設定がいくつかあります。 その他の設定を構成するには、 Set-CMApplicationGroup コマンドレットを使用します。

注:

PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。

例

例 1: 2 つのアプリを使用してグループを作成する

この例では、2 つのアプリを含む Central アプリ という名前の新しいアプリ グループを作成します。

$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

グループに追加するアプリ名の文字列配列を指定します。 Get-CMApplication などの別のコマンドレットのアプリ オブジェクトが既にある場合、この値は LocalizedDisplayName プロパティです。 例: $appList = @($app1.LocalizedDisplayName,$app2.LocalizedDisplayName)

型:String[]
Aliases:AddApplications
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-AddOwner

このアプリ グループを担当する 1 人以上の管理ユーザーを指定します。

型:String[]
Aliases:AddOwners
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-AddSupportContact

エンド ユーザーがこのアプリケーションに関するヘルプを問い合わせることができる 1 人以上の管理ユーザーを指定します。

型:String[]
Aliases:AddSupportContacts
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-AppGroupCatalog

特定の言語のソフトウェア センター エントリを指定するには、このパラメーターを使用します。 このエントリには、アプリ グループに関するローカライズされたすべての情報を含めることができます。

  • 説明
  • IconLocationFile
  • Keyword
  • LinkText
  • PrivacyUrl
  • タイトル
  • UserDocumentation

このオブジェクトを取得するには、 New-CMApplicationDisplayInfo コマンドレットを使用します。

型:AppDisplayInfo[]
Aliases:AppCatalogs
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultLanguageId

既定のソフトウェア センター言語の言語 ID を指定します。

この ID は、Windows 言語 ID に相当する 10 進数です。 たとえば、1033は英語 (米国) に0x0409され、2108はアイルランド (アイルランド) に0x083Cされます。 詳細については、「 [MS-LCID]: Windows 言語コード識別子 (LCID) リファレンス」を参照してください。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Description

アプリ グループのオプションの管理者コメントを指定します。 最大長は 2048 文字です。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-IconLocationFile

このアプリ グループのアイコンを含むファイルへのパスを指定します。 アイコンのピクセルサイズは最大 512 x 512 です。 ファイルには、次の画像とアイコン ファイルの種類を指定できます。

  • DLL
  • EXE
  • JPG
  • ICO
  • PNG
型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Keyword

選択した言語のキーワードの一覧を指定します。 これらのキーワードは、ソフトウェア センター ユーザーがアプリ グループを検索するのに役立ちます。

ヒント

複数のキーワードを追加するには、区切り記号として CultureInfo.CurrentCulture.TextInfo.ListSeparator を使用します。

型:String[]
Aliases:Keywords
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-LinkText

UserDocumentation パラメーターを使用する場合は、このパラメーターを使用して、ソフトウェア センターの "追加情報" の代わりに文字列を表示します。 最大の長さは 128 文字です。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-LocalizedDescription

選択した言語で、このアプリ グループの説明を指定します。 最大長は 2048 文字です。

型:String
Aliases:LocalizedAppGroupDescription
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-LocalizedName

選択した言語でアプリ グループ名を指定します。 この名前はソフトウェア センターに表示されます。

追加する言語ごとに名前が必要です。

最大の長さは 256 文字です。

型:String
Aliases:LocalizedAppGroupName
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

アプリ グループの名前を指定します。 最大の長さは 256 文字です。

型:String
Aliases:LocalizedDisplayName, ApplicationGroupName
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-OptionalReference

コンソールでアプリ グループを見つけるのに役立つ省略可能な文字列を指定します。 最大の長さは 256 文字です。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PrivacyUrl

アプリ グループのプライバシーに関する声明の Web サイト アドレスを指定します。 形式は、 https://contoso.com/privacyなど、有効な URL である必要があります。 文字列全体の最大長は 128 文字です。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Publisher

このアプリ グループのオプションのベンダー情報を指定します。 最大の長さは 256 文字です。

型:String
Aliases:Manufacturer
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ReleaseDate

このアプリ グループがリリースされたときの日付オブジェクトを指定します。 このオブジェクトを取得するには、 Get-Date 組み込みコマンドレットを使用します。

型:DateTime
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SoftwareVersion

アプリ グループの省略可能なバージョン文字列を指定します。 最大の長さは 64 文字です。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UserDocumentation

ソフトウェア センター ユーザーがこのアプリ グループに関する詳細情報を取得できるファイルの場所を指定します。 この場所は、Web サイトのアドレス、またはネットワーク パスとファイル名です。 ユーザーがこの場所にアクセスできることを確認します。

文字列全体の最大長は 256 文字です。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

None

出力

IResultObject

メモ

このコマンドレットは、 SMS_APPLICATIONGROUP WMI クラス オブジェクトを返します。