Set-CMApplicationGroup

モジュール:

ConfigurationManager

既存のアプリケーション グループを構成します。

構文

Set-CMApplicationGroup
   [-InputObject] <IResultObject>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationGroup
   [-Id] <Int32>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationGroup
   -ModelName <String>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationGroup
   [-Name] <String>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

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

注:

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

例

例 1: アプリ グループの名前を変更する

この例では、アプリ グループのオブジェクトを取得し、このコマンドレットに渡して名前を変更します。

$appgroup = Get-CMApplicationGroup -Name "Central app"
Set-CMApplicationGroup -InputObject $appgroup -NewName "Contoso Central App"

例 2: ローカライズされた名前を追加する

次の使用例は、 アイルランド 語のローカライズされたアプリ名でアプリ グループを構成します。

Set-CMApplicationGroup -Name "Contoso Welcome app" -ApplyToLanguageById 60 -LocalizedName "Fáilte romhat"

パラメーター

-AddAppCatalog

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

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

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

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

-AddAppCategory

コンソールでアプリ グループをフィルター処理して見つけるのに役立つ 1 つ以上の管理カテゴリ オブジェクトを指定します。 これらのオブジェクトを取得するには、 Get-CMCategory コマンドレットを 使用します。 これらのカテゴリの種類は AppCategories です。

ユーザーがソフトウェア センターでアプリケーションをフィルター処理および検索するのに役立つカテゴリを追加するには、 AddUserCategory パラメーターを使用します。

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

-AddApplication

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

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

-AddOwner

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

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

-AddSupportContact

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

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

-AddUserCategory

1 つ以上のユーザー カテゴリ オブジェクトを指定して、コンソールでアプリ グループをフィルター処理して見つけるのに役立ちます。 これらのオブジェクトを取得するには、 Get-CMCategory コマンドレットを 使用します。 これらのカテゴリの種類は CatalogCategories です。

ユーザーがソフトウェア センターでアプリケーションをフィルター処理および検索するのに役立つカテゴリを追加するには、 AddAppCategory パラメーターを使用します。

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

-ApplyToLanguageById

ソフトウェア センターに表示される設定の場合は、このパラメーターを使用して設定の言語 ID を指定します。

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

たとえば、 アイルランド語 (アイルランド) のローカライズされたアプリ名を追加するには、次のようにします。

-ApplyToLanguageById 2108 -LocalizedName "Fáilte romhat"

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

-CleanAppCategory

このパラメーターを追加して、すべての管理カテゴリを削除します。 1 つのカテゴリを削除するには、 RemoveAppCategory パラメーターを使用します。

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

-CleanUserCategory

このパラメーターを追加して、すべてのユーザー カテゴリを削除します。 1 つのカテゴリを削除するには、 RemoveUserCategory パラメーターを使用します。

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

-ClearAppCatalog

ローカライズされたすべてのソフトウェア センター エントリを削除するには、このパラメーターを追加します。 1 つのエントリを削除するには、 RemoveAppCatalog パラメーターを使用します。

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

-ClearOwner

このパラメーターを追加して、すべての所有者を削除します。 1 つの所有者を削除するには、 RemoveOwner パラメーターを使用します。

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

-ClearSupportContact

このパラメーターを追加して、すべてのサポート連絡先を削除します。 1 つの連絡先を削除するには、 RemoveSupportContact パラメーターを使用します。

型:	SwitchParameter
Aliases:	CleanSupportContacts
配置:	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

-Id

構成するアプリ グループの ID を指定します。 この値は、1025866など、CI_IDと同じです。

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

-InputObject

構成するアプリ グループ オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMApplicationGroup コマンドレットを 使用します。

型:	IResultObject
Aliases:	ApplicationGroup
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	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

-ModelName

構成するアプリ グループのアプリケーション モデル識別子を指定します。 この値は CI 一意 ID とも呼ばれます。 たとえば、「 ScopeId_0D7D8B60-F2F9-484A-B9F3-4A8B68D14D59/ApplicationGroup_047fbf05-55f4-42ab-9581-e63fd0337fed 」のように入力します。

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

-Name

構成するアプリ グループの名前を指定します。

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

-NewName

このパラメーターを使用して、アプリ グループの名前を変更します。 最大の長さは 256 文字です。

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

-OptionalReference

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

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

-PassThru

このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。

型:	SwitchParameter
配置:	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

-RemoveAppCatalog

言語 ID の配列を指定して、関連付けられているソフトウェア センター エントリを削除します。 すべてのエントリを削除するには、 ClearAppCatalog パラメーターを使用します。

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

たとえば、 アイルランド語 (アイルランド) のローカライズされたソフトウェア センター エントリを削除するには、次のようにします。

-RemoveAppCatalog 2108

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

-RemoveAppCategoryName

削除する管理カテゴリ名の配列を指定します。 すべての管理カテゴリを削除するには、 CleanAppCategory パラメーターを使用します。

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

-RemoveApplication

このグループから削除するアプリケーション名の配列を指定します。

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

-RemoveOwner

削除する所有者の配列を指定します。 すべての所有者を削除するには、 ClearOwner パラメーターを使用します。

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

-RemoveSupportContact

削除するサポート連絡先の配列を指定します。 すべてのサポート連絡先を削除するには、 ClearSupportContact パラメーターを使用します。

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

-RemoveUserCategoryName

削除するユーザー カテゴリ名の配列を指定します。 すべてのユーザー カテゴリを削除するには、 CleanUserCategory パラメーターを使用します。

型:	String[]
Aliases:	RemoveUserCategoryNames
配置:	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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject

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

関連リンク

• Get-CMApplicationGroup
• New-CMApplicationGroup
• Remove-CMApplicationGroup
• New-CMApplicationDisplayInfo
• Get-CMApplicationGroupDeployment
• New-CMApplicationGroupDeployment
• Remove-CMApplicationGroupDeployment
• Set-CMApplicationGroupDeployment
• アプリケーション グループを作成する