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진수입니다. 예를 들어 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 |
-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 클래스 개체를 반환합니다.