Set-CMApplication

Настройка свойств приложения.

Синтаксис

Set-CMApplication
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-AddAppCategory <IResultObject[]>]
   [-AddOwner <String[]>]
   [-AddSupportContact <String[]>]
   [-AddUserCategory <IResultObject[]>]
   [-AppCategory <String[]>]
   [-ApplyToLanguageById <Int32>]
   [-AutoInstall <Boolean>]
   [-CleanAppCategory]
   [-CleanUserCategory]
   [-ClearAppCatalog]
   [-ClearOwner]
   [-ClearSupportContact]
   [-DefaultLanguageId <Int32>]
   [-Description <String>]
   [-DisplaySupersedenceInApplicationCatalog <Boolean>]
   [-DistributionPointSetting <DistributionPointSettingType>]
   [-DistributionPriority <DistributionPriorityType>]
   [-IconLocationFile <String>]
   [-InputObject] <IResultObject>
   [-IsFeatured <Boolean>]
   [-Keyword <String[]>]
   [-LinkText <String>]
   [-LocalizedApplicationName <String>]
   [-LocalizedDescription <String>]
   [-NewName <String>]
   [-OptionalReference <String>]
   [-Owner <String>]
   [-PassThru]
   [-PrivacyUrl <String>]
   [-Publisher <String>]
   [-ReleaseDate <DateTime>]
   [-RemoveAppCatalog <Int32[]>]
   [-RemoveAppCategoryName <String[]>]
   [-RemoveOwner <String[]>]
   [-RemoveSupportContact <String[]>]
   [-RemoveUserCategoryName <String[]>]
   [-SendToProtectedDistributionPoint <Boolean>]
   [-SoftwareVersion <String>]
   [-SupportContact <String>]
   [-UserCategory <String[]>]
   [-UserDocumentation <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMApplication
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-AddAppCategory <IResultObject[]>]
   [-AddOwner <String[]>]
   [-AddSupportContact <String[]>]
   [-AddUserCategory <IResultObject[]>]
   [-AppCategory <String[]>]
   [-ApplyToLanguageById <Int32>]
   [-AutoInstall <Boolean>]
   [-CleanAppCategory]
   [-CleanUserCategory]
   [-ClearAppCatalog]
   [-ClearOwner]
   [-ClearSupportContact]
   [-DefaultLanguageId <Int32>]
   [-Description <String>]
   [-DisplaySupersedenceInApplicationCatalog <Boolean>]
   [-DistributionPointSetting <DistributionPointSettingType>]
   [-DistributionPriority <DistributionPriorityType>]
   [-IconLocationFile <String>]
   [-Id] <Int32>
   [-IsFeatured <Boolean>]
   [-Keyword <String[]>]
   [-LinkText <String>]
   [-LocalizedApplicationName <String>]
   [-LocalizedDescription <String>]
   [-NewName <String>]
   [-OptionalReference <String>]
   [-Owner <String>]
   [-PassThru]
   [-PrivacyUrl <String>]
   [-Publisher <String>]
   [-ReleaseDate <DateTime>]
   [-RemoveAppCatalog <Int32[]>]
   [-RemoveAppCategoryName <String[]>]
   [-RemoveOwner <String[]>]
   [-RemoveSupportContact <String[]>]
   [-RemoveUserCategoryName <String[]>]
   [-SendToProtectedDistributionPoint <Boolean>]
   [-SoftwareVersion <String>]
   [-SupportContact <String>]
   [-UserCategory <String[]>]
   [-UserDocumentation <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMApplication
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-AddAppCategory <IResultObject[]>]
   [-AddOwner <String[]>]
   [-AddSupportContact <String[]>]
   [-AddUserCategory <IResultObject[]>]
   [-AppCategory <String[]>]
   [-ApplyToLanguageById <Int32>]
   [-AutoInstall <Boolean>]
   [-CleanAppCategory]
   [-CleanUserCategory]
   [-ClearAppCatalog]
   [-ClearOwner]
   [-ClearSupportContact]
   [-DefaultLanguageId <Int32>]
   [-Description <String>]
   [-DisplaySupersedenceInApplicationCatalog <Boolean>]
   [-DistributionPointSetting <DistributionPointSettingType>]
   [-DistributionPriority <DistributionPriorityType>]
   [-IconLocationFile <String>]
   [-IsFeatured <Boolean>]
   [-Keyword <String[]>]
   [-LinkText <String>]
   [-LocalizedApplicationName <String>]
   [-LocalizedDescription <String>]
   -ModelName <String>
   [-NewName <String>]
   [-OptionalReference <String>]
   [-Owner <String>]
   [-PassThru]
   [-PrivacyUrl <String>]
   [-Publisher <String>]
   [-ReleaseDate <DateTime>]
   [-RemoveAppCatalog <Int32[]>]
   [-RemoveAppCategoryName <String[]>]
   [-RemoveOwner <String[]>]
   [-RemoveSupportContact <String[]>]
   [-RemoveUserCategoryName <String[]>]
   [-SendToProtectedDistributionPoint <Boolean>]
   [-SoftwareVersion <String>]
   [-SupportContact <String>]
   [-UserCategory <String[]>]
   [-UserDocumentation <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMApplication
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-AddAppCategory <IResultObject[]>]
   [-AddOwner <String[]>]
   [-AddSupportContact <String[]>]
   [-AddUserCategory <IResultObject[]>]
   [-AppCategory <String[]>]
   [-ApplyToLanguageById <Int32>]
   [-AutoInstall <Boolean>]
   [-CleanAppCategory]
   [-CleanUserCategory]
   [-ClearAppCatalog]
   [-ClearOwner]
   [-ClearSupportContact]
   [-DefaultLanguageId <Int32>]
   [-Description <String>]
   [-DisplaySupersedenceInApplicationCatalog <Boolean>]
   [-DistributionPointSetting <DistributionPointSettingType>]
   [-DistributionPriority <DistributionPriorityType>]
   [-IconLocationFile <String>]
   [-IsFeatured <Boolean>]
   [-Keyword <String[]>]
   [-LinkText <String>]
   [-LocalizedApplicationName <String>]
   [-LocalizedDescription <String>]
   [-Name] <String>
   [-NewName <String>]
   [-OptionalReference <String>]
   [-Owner <String>]
   [-PassThru]
   [-PrivacyUrl <String>]
   [-Publisher <String>]
   [-ReleaseDate <DateTime>]
   [-RemoveAppCatalog <Int32[]>]
   [-RemoveAppCategoryName <String[]>]
   [-RemoveOwner <String[]>]
   [-RemoveSupportContact <String[]>]
   [-RemoveUserCategoryName <String[]>]
   [-SendToProtectedDistributionPoint <Boolean>]
   [-SoftwareVersion <String>]
   [-SupportContact <String>]
   [-UserCategory <String[]>]
   [-UserDocumentation <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Для настройки параметров приложения используйте комлет Set-CMApplication.

Примечание

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

Примеры

Пример 1. Перенастройка свойств приложения

Первая команда получает объект приложения с именем Application01. Следующие две команды используют командлет Get-CMCategory для получения объектов для категории пользователя и администратора. Затем комлет Set-CMApplication задает указанные свойства в Applicaton01.

$app = Get-CMApplication -Name "Application01"
$userCat = Get-CMCategory -Name "Test Applications" -CategoryType CatalogCategories
$adminCat = Get-CMCategory -Name "Testing" -CategoryType AppCategories

Set-CMApplication -InputObject $app -NewName "Application01_New" -Description "Application updated" -Publisher "Test group" -SoftwareVersion "1.0.0.1" -OptionalReference "Reference" -ReleaseDate 2/24/2016 -AutoInstall $True -Owner "jqpublic" -SupportContact "jqpublic" -LocalizedApplicationName "Localized Application01" -UserDocumentation "https://contoso.com/content" -LinkText "For more info" -LocalizedDescription "Localized Application New" -Keyword "Application" -PrivacyUrl "https://contoso.com/privacy" -IsFeatured $True -IconLocationFile "C:\Users\art\icon.png" -DistributionPriority Medium -SendToProtectedDistributionPoint $True -DistributionPointSetting NoDownload -AddUserCategory $userCat -AddAppCategory $adminCat

Параметры

-AddAppCatalog

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

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

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

Type:AppDisplayInfo[]
Aliases:AppCatalogs
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AddAppCategory

Укажите один или несколько объектов административной категории, чтобы помочь фильтровать и находить приложение на консоли. Чтобы получить эти объекты, используйте cmdlet Get-CMCategory. Эти категории имеют тип AppCategories.

Чтобы добавить категории, которые помогут пользователям фильтровать и находить приложения в Центре программного обеспечения, используйте параметр AddUserCategory.

Type:IResultObject[]
Aliases:AddAppCategories
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AddOwner

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

Type:String[]
Aliases:AddOwners
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AddSupportContact

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

Type:String[]
Aliases:AddSupportContacts
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AddUserCategory

Укажите один или несколько объектов категории пользователей, чтобы помочь фильтровать и находить группу приложений на консоли. Чтобы получить эти объекты, используйте cmdlet Get-CMCategory. Эти категории имеют тип CatalogCategories.

Чтобы добавить категории, которые помогут пользователям фильтровать и находить приложения в Центре программного обеспечения, используйте параметр AddAppCategory.

Type:IResultObject[]
Aliases:AddUserCategories
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AppCategory

Этот параметр является амортизации, использование -AddAppCategory.

Type:String[]
Aliases:AppCategories
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ApplyToLanguageById

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

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

Например, чтобы добавить локализованное имя приложения для Ирландского (Ирландия):

-ApplyToLanguageById 2108 -LocalizedName "Fáilte romhat"

Type:Int32
Aliases:ApplySettingToSpecificLanguage
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AutoInstall

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CleanAppCategory

Добавьте этот параметр, чтобы удалить все административные категории. Чтобы удалить одну категорию, используйте параметр RemoveAppCategory.

Type:SwitchParameter
Aliases:CleanAppCategories
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CleanUserCategory

Добавьте этот параметр, чтобы удалить все категории пользователей. Чтобы удалить одну категорию, используйте параметр RemoveUserCategory.

Type:SwitchParameter
Aliases:CleanUserCategories
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ClearAppCatalog

Добавьте этот параметр, чтобы удалить все локальные записи Центра программного обеспечения. Чтобы удалить одну запись, используйте параметр RemoveAppCatalog.

Type:SwitchParameter
Aliases:ClearAppCatalogs, CleanAppCatalog, CleanAppCatalogs
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ClearOwner

Добавьте этот параметр, чтобы удалить всех владельцев. Чтобы удалить одного владельца, используйте параметр RemoveOwner.

Type:SwitchParameter
Aliases:CleanOwners
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ClearSupportContact

Добавьте этот параметр, чтобы удалить все контакты поддержки. Чтобы удалить один контакт, используйте параметр RemoveSupportContact.

Type:SwitchParameter
Aliases:CleanSupportContacts
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultLanguageId

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

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

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisplaySupersedenceInApplicationCatalog

Несмотря на то, что каталог приложений больше не поддерживается, этот параметр можно использовать для того, чтобы пользователи могли видеть в развертываниях Центра программного обеспечения для этого приложения и всех приложений, которые он выдержает.

Type:Boolean
Aliases:DisplaySupersedencesInApplicationCatalog
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DistributionPointSetting

Укажите предустановленные параметры точки распространения:

  • AutoDownload. Автоматически скачивать контент, когда пакеты назначены точкам распространения.

  • DeltaCopy: Скачайте только изменения контента в точки распространения.

  • NoDownload: Вручную скопируйте содержимое этого пакета в точки распространения.

Type:DistributionPointSettingType
Accepted values:AutoDownload, DeltaCopy, NoDownload
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DistributionPriority

Укажите порядок отправки контента на другие сайты и точки распространения на этом сайте.

Сайт отправляет высокооритетный контент перед содержимым со средним или низким приоритетом. Содержимое с равным приоритетом отправляется в том порядке, в котором они создаются.

Type:DistributionPriorityType
Accepted values:High, Medium, Low
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-IconLocationFile

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

  • DLL
  • EXE
  • JPG
  • ICO
  • PNG
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Id

Укажите ID приложения для настройки. Это значение такое же, как CI_ID, например 1025866 .

Type:Int32
Aliases:CIId, CI_ID
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

Type:IResultObject
Aliases:Application
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-IsFeatured

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Keyword

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

Совет

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

Type:String[]
Aliases:Keywords
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-LinkText

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-LocalizedApplicationName

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

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

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-LocalizedDescription

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

Type:String
Aliases:LocalizedApplicationDescription
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ModelName

Укажите идентификатор модели приложения для настройки. Это значение также называется ci Unique ID. Например, ScopeId_0D7D8B60-F2F9-484A-B9F3-4A8B68D14D59/ApplicationGroup_047fbf05-55f4-42ab-9581-e63fd0337fed.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

Укажите имя приложения для настройки.

Type:String
Aliases:LocalizedDisplayName, ApplicationName
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-NewName

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-OptionalReference

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Owner

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PrivacyUrl

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Publisher

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

Type:String
Aliases:Manufacturer
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ReleaseDate

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

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RemoveAppCatalog

Укажите массив языковых ИД, чтобы удалить связанные записи Центра программного обеспечения. Чтобы удалить все записи, используйте параметр ClearAppCatalog.

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

Например, чтобы удалить локализованную запись Центра программного обеспечения для ирландских (Ирландия):

-RemoveAppCatalog 2108

Type:Int32[]
Aliases:RemoveAppCatalogsByLanguageId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RemoveAppCategoryName

Укажите массив имен административных категорий, которые необходимо удалить. Чтобы удалить все административные категории, используйте параметр CleanAppCategory.

Type:String[]
Aliases:RemoveAppCategoryNames
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RemoveOwner

Укажите массив владельцев, которые необходимо удалить. Чтобы удалить всех владельцев, используйте параметр ClearOwner.

Type:String[]
Aliases:RemoveOwners
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RemoveSupportContact

Укажите массив контактов поддержки для удаления. Чтобы удалить все контакты поддержки, используйте параметр ClearSupportContact.

Type:String[]
Aliases:RemoveSupportContacts
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RemoveUserCategoryName

Укажите массив имен категорий пользователей, которые необходимо удалить. Чтобы удалить все категории пользователей, используйте параметр CleanUserCategory.

Type:String[]
Aliases:RemoveUserCategoryNames
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SendToProtectedDistributionPoint

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SoftwareVersion

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SupportContact

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UserCategory

Этот параметр является амортизации, использование -AddUserCategory.

Type:String[]
Aliases:UserCategories
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UserDocumentation

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

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

IResultObject

Примечания

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