Set-CMApplicationGroup

  • 참조
모듈:
ConfigurationManager

기존 애플리케이션 그룹을 구성합니다.

구문

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을 사용합니다.

형식:AppDisplayInfo[]
별칭:AppCatalogs
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AddAppCategory

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

사용자가 소프트웨어 센터에서 애플리케이션을 필터링하고 찾는 데 도움이 되는 범주를 추가하려면 AddUserCategory 매개 변수를 사용합니다.

형식:IResultObject[]
별칭:AddAppCategories
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AddApplication

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

형식:String[]
별칭:AddApplications
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AddOwner

이 앱 그룹을 담당하는 관리 사용자를 하나 이상 지정합니다.

형식:String[]
별칭:AddOwners
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AddSupportContact

최종 사용자가 이 애플리케이션에 대한 도움을 요청하기 위해 연락할 수 있는 하나 이상의 관리 사용자를 지정합니다.

형식:String[]
별칭:AddSupportContacts
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AddUserCategory

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

사용자가 소프트웨어 센터에서 애플리케이션을 필터링하고 찾는 데 도움이 되는 범주를 추가하려면 AddAppCategory 매개 변수를 사용합니다.

형식:IResultObject[]
별칭:AddUserCategories
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ApplyToLanguageById

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

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

예를 들어 아일랜드어(아일랜드)의 지역화된 앱 이름을 추가하려면 다음을 수행합니다.

-ApplyToLanguageById 2108 -LocalizedName "Fáilte romhat"

형식:Int32
별칭:ApplySettingToSpecificLanguage
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-CleanAppCategory

이 매개 변수를 추가하여 모든 관리 범주를 제거합니다. 단일 범주를 제거하려면 RemoveAppCategory 매개 변수를 사용합니다.

형식:SwitchParameter
별칭:CleanAppCategories
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-CleanUserCategory

이 매개 변수를 추가하여 모든 사용자 범주를 제거합니다. 단일 범주를 제거하려면 RemoveUserCategory 매개 변수를 사용합니다.

형식:SwitchParameter
별칭:CleanUserCategories
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ClearAppCatalog

지역화된 모든 소프트웨어 센터 항목을 제거하려면 이 매개 변수를 추가합니다. 단일 항목을 제거하려면 RemoveAppCatalog 매개 변수를 사용합니다.

형식:SwitchParameter
별칭:ClearAppCatalogs, CleanAppCatalog, CleanAppCatalogs
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ClearOwner

이 매개 변수를 추가하여 모든 소유자를 제거합니다. 단일 소유자를 제거하려면 RemoveOwner 매개 변수를 사용합니다.

형식:SwitchParameter
별칭:CleanOwners
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ClearSupportContact

이 매개 변수를 추가하여 모든 지원 연락처를 제거합니다. 단일 연락처를 제거하려면 RemoveSupportContact 매개 변수를 사용합니다.

형식:SwitchParameter
별칭:CleanSupportContacts
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Confirm

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

형식:SwitchParameter
별칭:cf
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DefaultLanguageId

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

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

형식: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

-ForceWildcardHandling

이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-IconLocationFile

이 앱 그룹의 아이콘이 포함된 파일의 경로를 지정합니다. 아이콘의 픽셀 크기는 최대 512x512일 수 있습니다. 파일은 다음 이미지 및 아이콘 파일 형식일 수 있습니다.

  • DLL
  • EXE
  • JPG
  • ICO
  • PNG
형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Id

구성할 앱 그룹의 ID를 지정합니다. 이 값은 CI_ID(예 1025866: )와 동일합니다.

형식:Int32
별칭:CIId, CI_ID
Position:0
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputObject

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

형식:IResultObject
별칭:ApplicationGroup
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Keyword

선택한 언어로 키워드 목록을 지정합니다. 이러한 키워드는 소프트웨어 센터 사용자가 앱 그룹을 검색하는 데 도움이 됩니다.

팁

여러 키워드를 추가하려면 CultureInfo.CurrentCulture.TextInfo.ListSeparator 를 구분 기호로 사용합니다.

형식:String[]
별칭:Keywords
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-LinkText

UserDocumentation 매개 변수를 사용하는 경우 이 매개 변수를 사용하여 소프트웨어 센터에서 "추가 정보" 대신 문자열을 표시합니다. 최대 길이는 128자입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-LocalizedDescription

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

형식:String
별칭:LocalizedAppGroupDescription
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-LocalizedName

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

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

최대 길이는 256자입니다.

형식:String
별칭:LocalizedAppGroupName
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ModelName

구성할 앱 그룹의 애플리케이션 모델 식별자를 지정합니다. 이 값을 CI 고유 ID라고도 합니다. 예를 들면 ScopeId_0D7D8B60-F2F9-484A-B9F3-4A8B68D14D59/ApplicationGroup_047fbf05-55f4-42ab-9581-e63fd0337fed와 같습니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Name

구성할 앱 그룹의 이름을 지정합니다.

형식:String
별칭:LocalizedDisplayName, ApplicationGroupName
Position:0
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-NewName

이 매개 변수를 사용하여 앱 그룹의 이름을 바꿉니다. 최대 길이는 256자입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-OptionalReference

콘솔에서 앱 그룹을 찾는 데 도움이 되는 선택적 문자열을 지정합니다. 최대 길이는 256자입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PassThru

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

형식:SwitchParameter
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
별칭:Manufacturer
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ReleaseDate

이 앱 그룹이 릴리스된 날짜 개체를 지정합니다. 이 개체를 얻으려면 Get-Date 기본 제공 cmdlet을 사용합니다.

형식:DateTime
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RemoveAppCatalog

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

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

예를 들어 아일랜드어(아일랜드)에 대한 지역화된 소프트웨어 센터 항목을 제거하려면 다음을 수행합니다.

-RemoveAppCatalog 2108

형식:Int32[]
별칭:RemoveAppCatalogsByLanguageId
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RemoveAppCategoryName

제거할 관리 범주 이름의 배열을 지정합니다. 모든 관리 범주를 제거하려면 CleanAppCategory 매개 변수를 사용합니다.

형식:String[]
별칭:RemoveAppCategoryNames
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RemoveApplication

이 그룹에서 제거할 애플리케이션 이름 배열을 지정합니다.

형식:String[]
별칭:RemoveApplications
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RemoveOwner

제거할 소유자 배열을 지정합니다. 모든 소유자를 제거하려면 ClearOwner 매개 변수를 사용합니다.

형식:String[]
별칭:RemoveOwners
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RemoveSupportContact

제거할 지원 연락처 배열을 지정합니다. 모든 지원 연락처를 제거하려면 ClearSupportContact 매개 변수를 사용합니다.

형식:String[]
별칭:RemoveSupportContacts
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RemoveUserCategoryName

제거할 사용자 범주 이름의 배열을 지정합니다. 모든 사용자 범주를 제거하려면 CleanUserCategory 매개 변수를 사용합니다.

형식:String[]
별칭:RemoveUserCategoryNames
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SoftwareVersion

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

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-UserDocumentation

소프트웨어 센터 사용자가 이 앱 그룹에 대한 자세한 정보를 얻을 수 있는 파일의 위치를 지정합니다. 이 위치는 웹 사이트 주소 또는 네트워크 경로 및 파일 이름입니다. 사용자가 이 위치에 액세스할 수 있는지 확인합니다.

전체 문자열의 최대 길이는 256자입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

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

형식:SwitchParameter
별칭:wi
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

IResultObject

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