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

説明

このコマンドレットを使用してアプリケーションを作成します。 Configuration Manager アプリケーションは、アプリケーションに関するメタデータを定義します。 詳細については、「 Configuration Manager でアプリケーションを作成する」を参照してください。

注:

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

例

例 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

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

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

-AddSupportContact

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

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

-AppCatalog

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

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

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

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

-AutoInstall

このパラメーターを $true に設定すると、[アプリケーションのインストール] タスク シーケンス ステップからアプリを展開せずにインストールできるようになります。

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

-Confirm

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

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	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

-DisplaySupersedenceInApplicationCatalog

このパラメーターは使用しないでください。 アプリケーション カタログはサポートされなくなりました。

型:	Boolean
Aliases:	DisplaySupersedencesInApplicationCatalog
配置:	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

-IsFeatured

このパラメーターを $true に設定して、このアプリケーションを注目のアプリとして表示し、ポータル サイトで強調表示します。

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

-LocalizedName

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

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

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

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

-Name

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

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

-OptionalReference

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

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

-Owner

このアプリを担当する管理ユーザーを指定します。

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

-SupportContact

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

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

-UserDocumentation

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

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

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

-WhatIf

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

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

入力

None

出力

IResultObject

IResultObject

メモ

この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_Application」を参照してください。

関連リンク

• Convert-CMApplication
• ConvertFrom-CMApplication
• ConvertTo-CMApplication
• Export-CMApplication
• Get-CMApplication
• Import-CMApplication
• Remove-CMApplication
• Resume-CMApplication
• Set-CMApplication
• Suspend-CMApplication
• New-CMApplicationDisplayInfo
• Configuration Manager でアプリケーションを作成する