New-CMApplicationGroup

새 애플리케이션 그룹을 만듭니다.

구문

New-CMApplicationGroup
   [-Name] <String>
   -AddApplication <String[]>
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-AddSupportContact <String[]>]
   [-AppGroupCatalog <AppDisplayInfo[]>]
   [-DefaultLanguageId <Int32>]
   [-LocalizedName <String>]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

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

앱 그룹을 만들 때 구성할 수 없는 몇 가지 설정이 있습니다. 다른 설정을 구성하려면 Set-CMApplicationGroup cmdlet을 사용합니다.

참고

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

예제

예제 1: 두 개의 앱이 있는 그룹 만들기

이 예제에서는 두 개의 앱을 포함하는 Central 앱 이라는 새 앱 그룹을 만듭니다.

$apps = @('LOB Framework','CA UI')

New-CMApplicationGroup -Name 'Central app' -AddApplication $apps -Description 'Central app group' -Publisher 'Contoso IT' -SoftwareVersion '1.1.2' -ReleaseDate (Get-Date) -AddOwner 'jqpublic' -AddSupportContact 'jdoe' -LocalizedAppGroupName 'Central app'

매개 변수

-AddApplication

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

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

-AddOwner

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

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

-AddSupportContact

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

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

-AppGroupCatalog

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

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

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

형식:AppDisplayInfo[]
별칭:AppCatalogs
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진수입니다. 예를 들어 10330x0409영어(미국)이며 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

-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

-Name

앱 그룹의 이름을 지정합니다. 최대 길이는 256자입니다.

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

-OptionalReference

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

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

-ReleaseDate

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

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

입력

None

출력

IResultObject

참고

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