New-CMApplicationGroup
新しいアプリケーション グループを作成します。
構文
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 つの展開として展開します。 アプリ グループに関して指定したメタデータは、ソフトウェア センターで 1 つのエンティティとして表示されます。 クライアントが特定の順序でインストールできるよう、グループ内のアプリを注文できます。 詳細については、「アプリケーション グループの作成 」を参照してください。
アプリ グループの設定には、作成時に構成できない設定があります。 他の設定を構成するには 、Set-CMApplicationGroup コマンドレットを使用 します。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\>
。 詳細については 、「Getting started」を参照してください。
例
例 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)
Type: | String[] |
Aliases: | AddApplications |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddOwner
このアプリ グループを担当する 1 つ以上の管理ユーザーを指定します。
Type: | String[] |
Aliases: | AddOwners |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddSupportContact
エンド ユーザーがこのアプリケーションのヘルプに連絡できる 1 つ以上の管理ユーザーを指定します。
Type: | String[] |
Aliases: | AddSupportContacts |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AppGroupCatalog
このパラメーターを使用して、特定の言語のソフトウェア センター エントリを指定します。 このエントリには、アプリ グループに関するローカライズされた情報のすべてが含まれます。
- 説明
- IconLocationFile
- キーワード
- LinkText
- PrivacyUrl
- Title
- UserDocumentation
このオブジェクトを取得するには 、New-CMApplicationDisplayInfo コマンドレットを使用 します。
Type: | AppDisplayInfo[] |
Aliases: | AppCatalogs |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultLanguageId
既定のソフトウェア センター言語の言語 ID を指定します。
この ID は、言語 ID の 10 進数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 です。 ファイルには、次の画像ファイルとアイコン ファイルの種類を指定できます。
- DLL
- EXE
- JPG
- ICO
- PNG
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Keyword
選択した言語でキーワードの一覧を指定します。 これらのキーワードは、ソフトウェア センターのユーザーがアプリ グループを検索するのに役立ちます。
ヒント
複数のキーワードを追加するには、 区切り文字として CultureInfo.CurrentCulture.TextInfo.ListSeparator を使用します。
Type: | String[] |
Aliases: | Keywords |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LinkText
UserDocumentationパラメーターを使用する場合は、このパラメーターを使用して、ソフトウェア センターの "追加情報" の代りで文字列を表示します。 最大の長さは 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 |
-Name
アプリ グループの名前を指定します。 最大の長さは 256 文字です。
Type: | String |
Aliases: | LocalizedDisplayName, ApplicationGroupName |
Position: | 0 |
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
アプリ グループのプライバシーに関する声明の Web サイト アドレスを指定します。 形式は、有効な 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 組み込 みのコマンドレットを使用します。
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
ソフトウェア センター ユーザーがこのアプリ グループの詳細を取得できるファイルの場所を指定します。 この場所は、Web サイトのアドレス、またはネットワーク パスとファイル名です。 ユーザーにこの場所へのアクセス権が設定されている必要があります。
文字列全体の最大長は 256 文字です。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
なし
出力
IResultObject
メモ
このコマンドレットは、WMI クラス SMS_ApplicationGroup を返します。