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. Например, 1033
— 0x0409
для английского (США) и 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 сервера.