New-CMApplication
アプリケーションを作成します。
構文
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」を参照してください。