New-CMApplicationDisplayInfo
アプリケーションまたはアプリケーション グループのソフトウェア センター エントリを作成します。
構文
New-CMApplicationDisplayInfo
[-Description <String>]
[-IconLocationFile <String>]
[-Keyword <String[]>]
-LanguageId <Int32>
[-LinkText <String>]
[-PrivacyUrl <String>]
-Title <String>
[-UserDocumentation <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
説明
このコマンドレットを使用して、アプリケーションまたはアプリケーション グループのソフトウェア センター エントリを作成します。 ソフトウェア センターを参照するときに、このアプリまたはアプリ グループをユーザーに表示する方法に関する情報を指定します。 特定の言語で情報を提供するには、言語 ID を指定します。
このコマンドレットは、New-CMApplication、New-CMApplicationGroup、Set-CMApplication、および Set-CMApplicationGroup コマンドレットに渡すことができるオブジェクトを作成します。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1
次の使用例は、 アイルランド 語でアプリ グループ エントリのすべての設定を収集し、アプリ グループに追加します。
$welcomeAppInfoIrish = New-CMApplicationDisplayInfo -Description "Fáilte a Contoso! Go raibh maith agat faoi theacht chugainn." -IconLocationFile "\\central\icons\welcome.ico" -Keyword "fostaí","nua" -LanguageId 60 -LinkText "Mar eolas duit" -PrivacyUrl "https://contoso.com/privacy" -Title "Fáilte romhat" -UserDocumentation "https://my.contoso.com/welcome"
Set-CMApplicationGroup -Name "Contoso Welcome app" -AddAppCatalog $welcomeAppInfoIrish
パラメーター
-Description
指定した言語でこのアプリの説明を指定します。 最大長は 2048 文字です。
型: | String |
Aliases: | LocalizedDescription |
配置: | 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
指定した言語でキーワードの一覧を指定します。 これらのキーワードは、ソフトウェア センターユーザーがアプリを検索するのに役立ちます。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-LanguageId
設定の言語 ID を指定するには、このパラメーターを使用します。
この ID は、Windows 言語 ID に相当する 10 進数です。 たとえば、1033
は英語 (米国) に0x0409
され、2108
はアイルランド (アイルランド) に0x083C
されます。 詳細については、「 [MS-LCID]: Windows 言語コード識別子 (LCID) リファレンス」を参照してください。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-LinkText
UserDocumentation パラメーターを使用する場合は、このパラメーターを使用して、ソフトウェア センターの "追加情報" の代わりに文字列を表示します。 最大の長さは 128 文字です。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PrivacyUrl
アプリのプライバシーに関する声明の Web サイト アドレスを指定します。 形式は、 https://contoso.com/privacy
など、有効な URL である必要があります。 文字列全体の最大長は 128 文字です。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Title
指定した言語でアプリ名を指定します。 この名前はソフトウェア センターに表示されます。 最大の長さは 256 文字です。
型: | String |
Aliases: | LocalizedName |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UserDocumentation
ソフトウェア センター ユーザーがこのアプリの詳細情報を取得できるファイルの場所を指定します。 この場所は、Web サイトのアドレス、またはネットワーク パスとファイル名です。 ユーザーがこの場所にアクセスできることを確認します。
文字列全体の最大長は 256 文字です。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
None
出力
AppDisplayInfo