Set-CMApplicationGroup
기존 응용 프로그램 그룹을 구성합니다.
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 반환합니다.