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.

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 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

Укажите одного или нескольких пользователей с правами администратора, которые отвечают за это приложение.

Тип:String[]
Aliases:AddOwners
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AddSupportContact

Укажите одного или нескольких пользователей с правами администратора, к которым конечные пользователи могут обратиться за помощью по этому приложению.

Тип:String[]
Aliases:AddSupportContacts
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AppCatalog

Используйте этот параметр, чтобы указать запись Центра программного обеспечения для определенного языка. Эта запись может содержать все локализованные сведения о приложении:

  • Описание
  • IconLocationFile
  • Ключевое слово
  • LinkText
  • PrivacyUrl
  • Название
  • UserDocumentation

Чтобы получить этот объект, используйте командлет New-CMApplicationDisplayInfo .

Тип:AppDisplayInfo[]
Aliases:AppCatalogs
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AutoInstall

Задайте для этого параметра значение $true , чтобы разрешить установку приложения на шаге последовательности задач Установка приложения без развертывания.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

Перед запуском командлет запросит подтверждение.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DefaultLanguageId

Укажите идентификатор языка для языка центра программного обеспечения по умолчанию.

Этот идентификатор является десятичным эквивалентом идентификатора языка Windows. Например, 10330x0409 для английского (США) и 2108 для 0x083Cирландского (Ирландия). Дополнительные сведения см. в разделе [MS-LCID]: Справочник по идентификатору кода языка Windows (LCID).

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Description

Укажите необязательный комментарий администратора для приложения. Максимальная длина — 2048 символов.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisplaySupersedenceInApplicationCatalog

Не используйте этот параметр. Каталог приложений больше не поддерживается.

Тип:Boolean
Aliases:DisplaySupersedencesInApplicationCatalog
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-IconLocationFile

Укажите путь к файлу, который содержит значок для этого приложения. Значки могут иметь размеры в пикселях до 512 x 512. Файл может иметь следующие типы файлов изображений и значков:

  • Библиотека dll
  • EXE
  • JPG
  • ICO
  • PNG
Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-IsFeatured

Задайте для этого параметра значение $true , чтобы отобразить это приложение в качестве рекомендуемого приложения и выделить его на корпоративном портале.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Keyword

Укажите список ключевых слов на выбранном языке. Эти ключевые слова помогают пользователям Центра программного обеспечения искать приложение.

Совет

Чтобы добавить несколько ключевых слов, используйте CultureInfo.CurrentCulture.TextInfo.ListSeparator в качестве разделителя.

Тип:String[]
Aliases:Keywords
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-LinkText

При использовании параметра UserDocumentation используйте этот параметр для отображения строки вместо "Дополнительные сведения" в Центре программного обеспечения. Максимальная длина — 128 символов.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-LocalizedDescription

Укажите описание для этого приложения на выбранном языке. Максимальная длина — 2048 символов.

Тип:String
Aliases:LocalizedApplicationDescription
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-LocalizedName

Укажите имя приложения на выбранном языке. Это имя отображается в Центре программного обеспечения.

Имя требуется для каждого добавляемого языка.

Максимальная длина составляет 256 символов.

Тип:String
Aliases:LocalizedApplicationName
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

Укажите имя приложения. Максимальная длина составляет 256 символов.

Тип:String
Aliases:LocalizedDisplayName
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-OptionalReference

Укажите необязательную строку для поиска приложения в консоли. Максимальная длина составляет 256 символов.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Owner

Укажите пользователя с правами администратора, ответственного за это приложение.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PrivacyUrl

Укажите адрес веб-сайта в заявлении о конфиденциальности для приложения. Формат должен быть допустимым URL-адресом, например https://contoso.com/privacy. Максимальная длина всей строки составляет 128 символов.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Publisher

Укажите дополнительные сведения о поставщике для этого приложения. Максимальная длина составляет 256 символов.

Тип:String
Aliases:Manufacturer
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ReleaseDate

Укажите объект даты для момента выпуска этого приложения. Чтобы получить этот объект, используйте встроенный командлет Get-Date .

Тип:DateTime
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SoftwareVersion

Укажите необязательную строку версии для приложения. Максимальная длина: 64 символа.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SupportContact

Укажите администратора, к которому пользователи могут обратиться за помощью по этому приложению.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-UserDocumentation

Укажите расположение файла, из которого пользователи Центра программного обеспечения могут получить дополнительные сведения об этом приложении. Это расположение является адресом веб-сайта или сетевым путем и именем файла. Убедитесь, что у пользователей есть доступ к этому расположению.

Максимальная длина всей строки составляет 256 символов.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

None

Выходные данные

IResultObject

IResultObject

Примечания

Дополнительные сведения об этом возвращаемом объекте и его свойствах см. в разделе SMS_Application класс WMI сервера.