Set-CMApplicationGroup

모듈:

ConfigurationManager

기존 응용 프로그램 그룹을 구성합니다.

Syntax

Set-CMApplicationGroup
   [-InputObject] <IResultObject>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationGroup
   [-Id] <Int32>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationGroup
   -ModelName <String>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationGroup
   [-Name] <String>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 기존 응용 프로그램 그룹의 설정을 구성합니다. 앱 그룹을 사용하여 컬렉션에 단일 배포로 여러 응용 프로그램을 배포합니다. 앱 그룹에 대해 지정하는 메타데이터는 소프트웨어 센터에서 단일 엔터티로 표시됩니다. 클라이언트가 특정 순서로 앱을 설치하도록 그룹에서 앱을 주문할 수 있습니다. 자세한 내용은 응용 프로그램 그룹 만들기를 참조하세요.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\> ). 자세한 내용은 시작을 참조하세요.

예제

예제 1: 앱 그룹 이름 바우기

이 예제에서는 앱 그룹의 개체를 다운로드하고 이름을 변경하기 위해 이 cmdlet에 전달합니다.

$appgroup = Get-CMApplicationGroup -Name "Central app"
Set-CMApplicationGroup -InputObject $appgroup -NewName "Contoso Central App"

예제 2: 지역화된 이름 추가

이 예제에서는 아일랜드어에 대한 지역화된 앱 이름으로 앱 그룹을 구성합니다.

Set-CMApplicationGroup -Name "Contoso Welcome app" -ApplyToLanguageById 60 -LocalizedName "Fáilte romhat"

매개 변수

-AddAppCatalog

이 매개 변수를 사용하여 특정 언어에 대한 소프트웨어 센터 항목을 지정합니다. 이 항목에는 앱 그룹에 대한 모든 지역화된 정보가 포함됩니다.

• 설명
• IconLocationFile
• 키워드
• LinkText
• PrivacyUrl
• 제목
• UserDocumentation

이 개체를 얻습니다. New-CMApplicationDisplayInfo cmdlet을 사용합니다.

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

-AddAppCategory

콘솔에서 앱 그룹을 필터링하고 찾는 데 도움이 되는 관리 범주 개체를 하나 이상 지정합니다. 이러한 개체를 사용하려면 Get-CMCategory cmdlet을 사용합니다. 이러한 범주는 AppCategories 유형입니다.

사용자가 소프트웨어 센터에서 응용 프로그램을 필터링하고 찾는 데 도움이 되는 범주를 추가하기 위해 AddUserCategory 매개 변수를 사용합니다.

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

-AddApplication

그룹에 추가할 앱 이름의 문자열 배열을 지정합니다. Get-CMApplication과같은 다른 cmdlet의 앱 개체가 이미 있는 경우 이 값은 LocalizedDisplayName 속성입니다. 예: $appList = @($app1.LocalizedDisplayName,$app2.LocalizedDisplayName)

Type:	String[]
Aliases:	AddApplications
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

콘솔에서 앱 그룹을 필터링하고 찾는 데 도움이 되는 하나 이상의 사용자 범주 개체를 지정합니다. 이러한 개체를 사용하려면 Get-CMCategory cmdlet을 사용합니다. 이러한 범주는 CatalogCategories 유형입니다.

사용자가 소프트웨어 센터에서 응용 프로그램을 필터링하고 찾는 데 도움이 되는 범주를 추가하기 위해 AddAppCategory 매개 변수를 사용합니다.

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

-ApplyToLanguageById

소프트웨어 센터에 표시하는 설정의 경우 이 매개 변수를 사용하여 설정의 언어 ID를 지정합니다.

이 ID는 언어 ID의 Windows 해당합니다. 예를 들어 1033 0x0409 영어(미국)의경우, 2108 0x083C 아일랜드어(아일랜드)의 경우 입니다. 자세한 내용은 [MS-LCID]: Windows LCID(언어 코드 식별자) 참조를 참조하세요.

예를 들어 아일랜드어(아일랜드)에 대한 지역화된 앱 이름을 추가합니다.

-ApplyToLanguageById 2108 -LocalizedName "Fáilte romhat"

Type:	Int32
Aliases:	ApplySettingToSpecificLanguage
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

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

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

-DefaultLanguageId

기본 소프트웨어 센터 언어의 언어 ID를 지정합니다.

이 ID는 언어 ID의 Windows 해당합니다. 예를 들어 1033 0x0409 영어(미국)의경우, 2108 0x083C 아일랜드어(아일랜드)의 경우 입니다. 자세한 내용은 [MS-LCID]: Windows LCID(언어 코드 식별자) 참조를 참조하세요.

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

-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

구성할 앱 그룹 개체를 지정합니다. 이 개체를 얻습니다. Get-CMApplicationGroup cmdlet을 사용합니다.

Type:	IResultObject
Aliases:	ApplicationGroup
Position:	0
Default value:	None
Accept pipeline input:	True
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

-LocalizedDescription

이 앱 그룹에 대한 설명을 선택한 언어로 지정합니다. 최대 길이는 2048자입니다.

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

-LocalizedName

선택한 언어로 앱 그룹 이름을 지정합니다. 이 이름은 소프트웨어 센터에 표시됩니다.

추가하는 각 언어에는 이름이 필요합니다.

최대 길이는 256자입니다.

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

-ModelName

구성할 앱 그룹의 응용 프로그램 모델 식별자를 지정합니다. 이 값을 CI 고유 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, ApplicationGroupName
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

-PassThru

이 매개 변수를 추가하여 작업할 항목을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않을 수 있습니다.

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 기본 제공 cmdlet을 사용합니다.

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

-RemoveAppCatalog

연결된 소프트웨어 센터 항목을 제거할 언어 ID 배열을 지정합니다. 모든 항목을 제거하려면 ClearAppCatalog 매개 변수를 사용합니다.

이 ID는 언어 ID의 Windows 해당합니다. 예를 들어 1033 0x0409 영어(미국)의경우, 2108 0x083C 아일랜드어(아일랜드)의 경우 입니다. 자세한 내용은 [MS-LCID]: Windows LCID(언어 코드 식별자) 참조를 참조하세요.

예를 들어 아일랜드어(아일랜드)에 대한 지역화된 소프트웨어 센터 항목을 제거하려면:

-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

-RemoveApplication

이 그룹에서 제거할 응용 프로그램 이름 배열을 지정합니다.

Type:	String[]
Aliases:	RemoveApplications
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

-SoftwareVersion

앱 그룹에 대한 선택적 버전 문자열을 지정합니다. 최대 길이는 64자입니다.

Type:	String
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

cmdlet이 실행되면 어떻게 되는지 보여줍니다. 이 cmdlet은 실행되지 않습니다.

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

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

IResultObject

이 cmdlet은 WMI 클래스 SMS_ApplicationGroup 반환합니다.

관련 링크

• Get-CMApplicationGroup
• New-CMApplicationGroup
• Remove-CMApplicationGroup
• New-CMApplicationDisplayInfo
• Get-CMApplicationGroupDeployment
• New-CMApplicationGroupDeployment
• Remove-CMApplicationGroupDeployment
• Set-CMApplicationGroupDeployment
• 응용 프로그램 그룹 만들기