New-App

모듈:: ExchangePowerShell

적용 대상:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수와 설정은 특정 환경에서만 사용할 수 있습니다.

New-App cmdlet을 사용하여 Outlook용 앱을 설치합니다.

아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.

구문

New-App
   [-Etoken <String>]
   [-MarketplaceCorrelationID <String>]
   [-MarketplaceAssetID <String>]
   [-MarketplaceQueryMarket <String>]
   [-MarketplaceServicesUrl <String>]
   [-MarketplaceUserProfileType <String>]
   [-AddInOverrides <AddInOverrides>]
   [-AllowReadWriteMailbox]
   [-AllowSetting <AllowSetting>]
   [-AppState <String>]
   [-AppType <String>]
   [-Confirm]
   [-DefaultStateForUser <DefaultStateForUser>]
   [-DomainController <Fqdn>]
   [-DownloadOnly]
   [-Enabled <Boolean>]
   [-Identity <String>]
   [-Mailbox <MailboxIdParameter>]
   [-OrganizationApp]
   [-PrivateCatalog]
   [-ProvidedTo <ClientExtensionProvidedTo>]
   [-UpdateAppState]
   [-UserList <MultiValuedProperty>]
   [-Version <String>]
   [-WhatIf]
   [<CommonParameters>]

New-App
   [-FileData <Byte[]>]
   [-AddInOverrides <AddInOverrides>]
   [-AllowReadWriteMailbox]
   [-AllowSetting <AllowSetting>]
   [-AppState <String>]
   [-AppType <String>]
   [-Confirm]
   [-DefaultStateForUser <DefaultStateForUser>]
   [-DomainController <Fqdn>]
   [-DownloadOnly]
   [-Enabled <Boolean>]
   [-Identity <String>]
   [-Mailbox <MailboxIdParameter>]
   [-OrganizationApp]
   [-PrivateCatalog]
   [-ProvidedTo <ClientExtensionProvidedTo>]
   [-UpdateAppState]
   [-UserList <MultiValuedProperty>]
   [-Version <String>]
   [-WhatIf]
   [<CommonParameters>]

New-App
   [-FileStream <Stream>]
   [-AddInOverrides <AddInOverrides>]
   [-AllowReadWriteMailbox]
   [-AllowSetting <AllowSetting>]
   [-AppState <String>]
   [-AppType <String>]
   [-Confirm]
   [-DefaultStateForUser <DefaultStateForUser>]
   [-DomainController <Fqdn>]
   [-DownloadOnly]
   [-Enabled <Boolean>]
   [-Identity <String>]
   [-Mailbox <MailboxIdParameter>]
   [-OrganizationApp]
   [-PrivateCatalog]
   [-ProvidedTo <ClientExtensionProvidedTo>]
   [-UpdateAppState]
   [-UserList <MultiValuedProperty>]
   [-Version <String>]
   [-WhatIf]
   [<CommonParameters>]

New-App
   [-Url <Uri>]
   [-AddInOverrides <AddInOverrides>]
   [-AllowReadWriteMailbox]
   [-AllowSetting <AllowSetting>]
   [-AppState <String>]
   [-AppType <String>]
   [-Confirm]
   [-DefaultStateForUser <DefaultStateForUser>]
   [-DomainController <Fqdn>]
   [-DownloadOnly]
   [-Enabled <Boolean>]
   [-Identity <String>]
   [-Mailbox <MailboxIdParameter>]
   [-OrganizationApp]
   [-PrivateCatalog]
   [-ProvidedTo <ClientExtensionProvidedTo>]
   [-UpdateAppState]
   [-UserList <MultiValuedProperty>]
   [-Version <String>]
   [-WhatIf]
   [<CommonParameters>]

Description

전체 organization 대해 앱을 사용하도록 설정한 경우 사용자는 Microsoft Outlook 또는 웹용 Outlook 내에서 메일 또는 일정 항목을 볼 때 새 앱을 활성화할 수 있습니다. 설치된 앱을 사용하도록 설정하지 않은 경우 사용자는 웹용 Outlook 옵션에서 앱을 사용하도록 설정할 수 있습니다. 마찬가지로 관리자는 Exchange 관리 센터에서 또는 Enable-App 또는 Set-App cmdlet을 사용하여 설치된 앱을 사용하도록 설정할 수 있습니다.

자세한 내용은 Exchange Server Outlook용 추가 기능에 대한 사용자 액세스 관리 및 Microsoft 365 관리 센터 추가 기능 배포 관리를 참조하세요.

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.

예제

예 1

New-App -FileData ([System.IO.File]::ReadAllBytes('C:\Apps\FinanceTestApp.xml'))

다음은 로컬 하드 디스크에 복사된 재무 테스트 앱 매니페스트 파일을 설치하는 예제입니다.

예 2

New-App -OrganizationApp -Url https://Server01.Contoso.com/apps/ContosoCRMApp/manifest.xml -ProvidedTo SpecificUsers -UserList "user1,user2,user3,user4,user5" -DefaultStateForUser Enabled

다음은 Contoso 회사 네트워크의 URL에서 manifest.xml Contoso CRM 앱을 설치하는 예제입니다. Exchange 서버가 대상 URL에 도달할 수 있어야 합니다. 이 앱은 organization 앱으로 설치되고, 특정 사용자 목록에서 사용할 수 있으며, 기본적으로 해당 사용자에 대해 사용하도록 설정됩니다.

매개 변수

-AddInOverrides

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

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

-AllowReadWriteMailbox

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

AllowReadWriteMailbox 스위치는 앱에서 읽기/쓰기 사서함 권한을 허용하는지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

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

-AllowSetting

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

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

-AppState

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

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

-AppType

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

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

-Confirm

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.

파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 일시 중지 기능이 기본 제공되어 있습니다. 이러한 cmdlet의 경우 정확한 구문 -Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다.
대부분 다른 cmdlets에는 (예:, New-* and Set-* cmdlets) 중단 기능이 기본 제공되지 않습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.

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

-DefaultStateForUser

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

DefaultStateForUser 매개 변수는 organization 앱의 기본 초기 상태를 지정합니다. 유효한 값은 다음과 같습니다.

사용: organization 앱은 기본적으로 사용하도록 설정됩니다.
사용 안 함: organization 앱은 기본적으로 사용하지 않도록 설정됩니다. 이 값은 기본값입니다.
AlwaysEnabled: organization 앱이 사용하도록 설정되고 사용자가 사용하지 않도록 설정할 수 없습니다.

이 매개 변수를 사용할 때는 OrganizationApp 스위치를 사용해야 합니다.

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

-DomainController

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com

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

-DownloadOnly

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

DownloadOnly 스위치는 실제 설치에 커밋하기 전에 앱 매니페스트 파일을 가져올지 여부를 지정하고 사용자에게 확인을 요청합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치를 사용하는 경우 cmdlet은 앱 매니페스트 파일만 다운로드하고 앱을 설치하지 않고 앱 속성을 표시합니다.

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

-Enabled

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Enabled 매개 변수는 조직의 사용자가 앱을 사용할 수 있게 할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$true: 지정된 사용자가 앱을 사용할 수 있습니다. 이 값은 기본값입니다.
$false: 앱은 organization 모든 사용자로부터 숨겨집니다.

이 설정은 ProvidedTo, UserList 및 DefaultStateForUser 설정을 재정의합니다. 사용자에게 설치 권한이 있는 경우에는 이 설정을 사용해도 사용자가 고유한 앱 인스턴스를 설치하는 것을 차단할 수 없습니다.

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

-Etoken

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

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

-FileData

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

FileData 매개 변수는 앱 매니페스트 파일의 위치를 지정합니다. 앱 매니페스트 파일에 대한 원본 위치를 하나만 지정해야 합니다. MarketplaceServicesUrl, Url 또는 FileData 매개 변수를 사용하여 앱 매니페스트 파일을 지정할 수 있습니다.

이 매개 변수에 유효한 값을 사용하려면 다음 구문을 ([System.IO.File]::ReadAllBytes('<Path>\<FileName>'))사용하여 바이트 인코딩된 개체로 파일을 읽어야 합니다. 이 명령을 매개 변수 값으로 사용하거나 변수($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>'))에 출력을 쓰고 변수를 매개 변수 값($data)으로 사용할 수 있습니다.

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

-FileStream

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

FileStream 매개 변수는 앱 파일 업로더를 지원하기 위해 Exchange 관리 센터에서만 사용됩니다. 이 매개 변수를 사용하여 앱 매니페스트 파일을 지정하지 마세요. MarketplaceServicesUrl, Url 또는 FileData 매개 변수를 사용하여 앱 매니페스트 파일을 지정할 수 있습니다.

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

-Identity

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

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

-Mailbox

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Mailbox 매개 변수는 앱을 설치할 사서함을 지정합니다. 사서함을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

이름
별칭
DN(고유 이름)
DN(고유 이름)
Domain\Username
전자 메일 주소
GUID
LegacyExchangeDN
SamAccountName
사용자 ID 또는 UPN(사용자 계정 이름)

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

-MarketplaceAssetID

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

MarketplaceAssetID 매개 변수는 앱에 대한 Office Store 식별자를 지정합니다. MarketplaceServicesUrl 매개 변수를 사용하는 경우 이 매개 변수를 사용해야 합니다.

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

-MarketplaceCorrelationID

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

MarketplaceCorrelationID 매개 변수는 앱에 대한 Office Store 상관 관계 식별자를 지정합니다.

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

-MarketplaceQueryMarket

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

MarketplaceQueryMarket 매개 변수는 Office Marketplace에서 앱이 아래에 제출되는 로캘을 지정합니다. 예를 들어 영어의 미국 시장에 대한 앱은 en-US 값을 사용합니다. 기본값은 en-US입니다.

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

-MarketplaceServicesUrl

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

MarketplaceServicesUrl 매개 변수는 앱에 대한 전체 서비스 URL을 지정합니다. 앱 매니페스트 파일에 대한 원본 위치를 하나만 지정해야 합니다. MarketplaceServicesUrl, Url 또는 FileData 매개 변수를 사용하여 앱 매니페스트 파일을 지정할 수 있습니다.

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

-MarketplaceUserProfileType

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

MarketplaceUserProfileType 매개 변수는 Office 스토어의 사용자 프로필 유형을 지정합니다.

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

-OrganizationApp

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

OrganizationApp 스위치는 앱의 범위가 특정 사용자에게 제한되지 않는 조직 범위임을 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

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

-PrivateCatalog

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Online

PrivateCatalog 스위치는 앱이 프라이빗 카탈로그에 있는지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

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

-ProvidedTo

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

ProvidedTo 매개 변수는 조직에서 앱의 가용성을 지정합니다. 유효한 값은 다음과 같습니다.

모두: 기본값입니다. 이 앱은 organization 모든 사용자에게 제공됩니다. 모든 사용자는 이 앱이 웹용 Outlook 옵션의 설치된 앱 목록에 나열된 것을 볼 수 있습니다. 설치된 앱 목록의 앱이 사용되도록 설정되면 사용자가 이 앱 기능을 전자 메일에서 사용할 수 있습니다. 앱 설치 권한이 있는 사용자를 포함한 모든 사용자가 고유한 앱 인스턴스를 설치하지 못하도록 차단됩니다.
SpecificUsers: 이 앱은 UserList 매개 변수로 지정된 사용자에게만 제공됩니다. 다른 모든 사용자는 관리 보기에서 이 조직 앱을 볼 수 없으며 메일 또는 일정 항목에서 활성화되지 않습니다. 지정된 사용자도 이 앱의 자체 instance 설치할 수 없습니다. 목록에 없는 사용자는 이 앱의 자체 instance 설치할 수 없습니다.

이 매개 변수는 OrganizationApp 스위치와 함께 사용할 수 있습니다.

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

-UpdateAppState

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

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

-Url

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Url 매개 변수는 설치하려는 앱 매니페스트 파일의 전체 URL 위치를 지정합니다. 앱 매니페스트 파일에 대한 원본 위치를 하나만 지정해야 합니다. MarketplaceServicesUrl, Url 또는 FileData 매개 변수를 사용하여 앱 매니페스트 파일을 지정할 수 있습니다.

참고: 리디렉션이 있는 URL은 Exchange Server 2016, Exchange Server 2019 및 Exchange Online 지원되지 않습니다. 매니페스트에 대한 직접 URL을 사용합니다.

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

-UserList

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

UserList 매개 변수는 조직 앱을 사용할 수 있는 사용자를 지정합니다. 이 매개 변수는 1,000명의 사용자로 제한됩니다. 클라우드 기반 서비스에서 이 값은 Office 추가 기능 관리가 중앙 집중식 배포로 이동함에 따라 관련성이 낮습니다.

사용할 수 있는 값은 조직의 사서함 또는 메일 사용자입니다. 사용자를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예시:

이름
별칭
DN(고유 이름)
DN(고유 이름)
Domain\Username
전자 메일 주소
GUID
LegacyExchangeDN
SamAccountName
사용자 ID 또는 UPN(사용자 계정 이름)

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

이 매개 변수는 OrganizationApp 스위치와 함께 사용할 수 있습니다.

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

-Version

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

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

-WhatIf

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Whatif 스위치는 해당 명령의 동작을 시뮬레이션합니다. 이 스위치를 사용하면 변경 내용을 실제로 적용하지 않고 발생할 변경 내용을 확인할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

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

입력

Input types

이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.

출력

Output types

이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.

다음을 통해 공유

New-App

구문

Description

예제

예 1

예 2

매개 변수

-AddInOverrides

-AllowReadWriteMailbox

-AllowSetting

-AppState

-AppType

-Confirm

-DefaultStateForUser

-DomainController

-DownloadOnly

-Enabled

-Etoken

-FileData

-FileStream

-Identity

-Mailbox

-MarketplaceAssetID

-MarketplaceCorrelationID

-MarketplaceQueryMarket

-MarketplaceServicesUrl

-MarketplaceUserProfileType

-OrganizationApp

-PrivateCatalog

-ProvidedTo

-UpdateAppState

-Url

-UserList

-Version

-WhatIf

입력

출력

피드백