New-MailUser

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

New-MailUser cmdlet을 사용하여 메일 사용자를 만들 수 있습니다. 메일 사용자(메일 사용 가능 사용자라고도 함)는 Exchange 조직에 전자 메일 주소와 계정을 가지고 있지만 Exchange 사서함은 없습니다. 메일 사용자에게 보내는 전자 메일 메시지는 지정된 외부 전자 메일 주소로 배달됩니다.

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

Syntax

New-MailUser
   [-Name] <String>
   -ExternalEmailAddress <ProxyAddress>
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Confirm]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MacAttachmentFormat <MacAttachmentFormat>]
   [-MailboxRegion <String>]
   [-MessageBodyFormat <MessageBodyFormat>]
   [-MessageFormat <MessageFormat>]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <Boolean>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <Boolean>]
   [-ResetPasswordOnNextLogon <Boolean>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <TransportModerationNotificationFlags>]
   [-UsePreferMessageFormat <Boolean>]
   [-WhatIf]
   [<CommonParameters>]
New-MailUser
   [-Name] <String>
   -ExternalEmailAddress <ProxyAddress>
   -Password <SecureString>
   -UserPrincipalName <String>
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Confirm]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MacAttachmentFormat <MacAttachmentFormat>]
   [-MailboxRegion <String>]
   [-MessageBodyFormat <MessageBodyFormat>]
   [-MessageFormat <MessageFormat>]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <Boolean>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <Boolean>]
   [-ResetPasswordOnNextLogon <Boolean>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <TransportModerationNotificationFlags>]
   [-UsePreferMessageFormat <Boolean>]
   [-WhatIf]
   [<CommonParameters>]
New-MailUser
   [-Name] <String>
   -MicrosoftOnlineServicesID <WindowsLiveId>
   -Password <SecureString>
   [-ExternalEmailAddress <ProxyAddress>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Confirm]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxRegion <String>]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <Boolean>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <Boolean>]
   [-ResetPasswordOnNextLogon <Boolean>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <TransportModerationNotificationFlags>]
   [-WhatIf]
   [<CommonParameters>]
New-MailUser
   [-Name] <String>
   -FederatedIdentity <String>
   [-ExternalEmailAddress <ProxyAddress>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Confirm]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxRegion <String>]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <Boolean>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <Boolean>]
   [-ResetPasswordOnNextLogon <Boolean>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <TransportModerationNotificationFlags>]
   [-WhatIf]
   [<CommonParameters>]
New-MailUser
   [-Name] <String>
   -FederatedIdentity <String>
   -MicrosoftOnlineServicesID <WindowsLiveId>
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Confirm]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxRegion <String>]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <Boolean>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <Boolean>]
   [-ResetPasswordOnNextLogon <Boolean>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <TransportModerationNotificationFlags>]
   [-WhatIf]
   [<CommonParameters>]
New-MailUser
   [-Name] <String>
   [-MicrosoftOnlineServicesID <WindowsLiveId>]
   [-Alias <String>]
   [-Confirm]
   [-DisplayName <String>]
   [-FirstName <String>]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxRegion <String>]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <Boolean>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-RemotePowerShellEnabled <Boolean>]
   [-SendModerationNotifications <TransportModerationNotificationFlags>]
   [-WhatIf]
   [<CommonParameters>]

Description

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

예제

예 1

New-MailUser -Name "Ed Meadows" -ExternalEmailAddress ed@tailspintoys.com -MicrosoftOnlineServicesID ed@contoso.com -Password (Get-Credential).password

이 예에서는 contoso.com 클라우드 기반 조직의 Ed Meadows에 대해 새 메일 사용자를 만듭니다. 메일 사용자를 만들면 contoso.com 도메인의 계정과 전자 메일 주소가 Ed에게 제공되지만, Ed에게 보내는 메시지는 Ed의 tailspintoys.com 전자 메일 주소로 배달됩니다.

매개 변수

-Alias

Alias 매개 변수는 받는 사람의 Exchange 별칭(메일 애칭이라고도 함)을 지정합니다. 이 값은 받는 사람을 메일 사용이 가능한 개체로 식별하며, 동일한 받는 사람에 대한 여러 전자 메일 주소(프록시 주소라고도 함)를 혼동하지 않아야 합니다. 받는 사람은 Alias 값을 하나만 가질 수 있습니다. 최대 길이는 64자입니다.

별칭 값에는 문자, 숫자 및 다음 문자가 포함될 수 있습니다.

  • !, #, %, *, +, -, /, =, ?, ^, _, ~.
  • $, &, ', ', {, }및 | 이스케이프(예: -Alias what`'snew) 또는 작은따옴표로 묶인 전체 값(예: -Alias 'what'snew')을 이스케이프해야 합니다. 문자는 & Azure AD Connect 동기화에 대한 별칭 값에서 지원되지 않습니다.
  • 마침표(.)는 다른 유효한 문자(예: help.desk)로 묶어야 합니다.
  • 유니코드 문자 U+00A1에서 U+00FF로

전자 메일 주소를 지정하지 않고 받는 사람을 만들 때 지정한 별칭 값은 기본 전자 메일 주소(alias@domain)를 생성하는 데 사용됩니다. 지원되는 유니코드 문자는 가장 적합한 US-ASCII 텍스트 문자에 매핑됩니다. 예를 들어 U+00F6(ö)은 기본 전자 메일 주소에서 로 변경됩니다 oe .

받는 사람을 만들 때 Alias 매개 변수를 사용하지 않는 경우 별칭 속성 값에 다른 필수 매개 변수의 값이 사용됩니다.

  • 사용자 계정(예: 사용자 사서함 및 메일 사용자)이 있는 받는 사람: MicrosoftOnlineServicesID 또는 UserPrincipalName 매개 변수의 왼쪽이 사용됩니다. 예를 들어 별 helpdesk@contoso.onmicrosoft.com 칭 속성 값 helpdesk이 입니다.
  • 사용자 계정이 없는 받는 사람(예: 회의실 사서함, 메일 연락처 및 메일 그룹): Name 매개 변수 값이 사용됩니다. 공백이 제거되고 지원되지 않는 문자가 물음표(?)로 변환됩니다.

기존 받는 사람의 별칭 값을 수정하는 경우 받는 사람에게 전자 메일 주소 정책이 적용되는 환경에서만 기본 전자 메일 주소가 자동으로 업데이트됩니다(받는 사람의 경우 EmailAddressPolicyEnabled 속성은 True임).

Alias 매개 변수는 메일 연락처 또는 메일 사용자의 기본 전자 메일 주소를 생성하거나 업데이트하지 않습니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ArbitrationMailbox

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

ArbitrationMailbox 매개 변수는 이 받는 사람에 대해 중재 프로세스를 관리하는 데 사용되는 중재 사서함을 지정합니다. 중재 사서함을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예시:

  • 이름
  • 별칭
  • DN(고유 이름)
  • DN(고유 이름)
  • Domain\Username
  • 전자 메일 주소
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 사용자 ID 또는 UPN(사용자 계정 이름)
Type:MailboxIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

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

  • 파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 기본 제공 일시 중지가 있습니다. 이러한 cmdlet의 경우 정확한 구문 -Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다.
  • 대부분의 다른 cmdlet(예: New-* 및 Set-* cmdlet)에는 기본 제공 일시 중지가 없습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DisplayName

DisplayName 매개 변수는 메일 사용자의 표시 이름을 지정합니다. 표시 이름은 Exchange 관리 센터, 주소 목록 및 Outlook에 표시됩니다. 최대 길이는 256자입니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

DisplayName 매개 변수를 사용하지 않는 경우에는 Name 매개 변수의 값이 표시 이름에 사용됩니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DomainController

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

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

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExternalEmailAddress

ExternalEmailAddress 매개 변수는 메일 연락처 또는 메일 사용자의 대상 전자 메일 주소를 지정합니다. 기본적으로 이 값은 메일 연락처 또는 메일 사용자의 기본 전자 메일 주소로 사용됩니다.

온-프레미스 환경에서 PrimarySMTPAddress 매개 변수를 사용하여 기본 전자 메일 주소를 다른 값으로 설정할 수 있습니다. 기본적으로 이 값은 메일 연락처 또는 메일 사용자의 기본 전자 메일 주소로 사용됩니다.

Type:ProxyAddress
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-FederatedIdentity

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

FederatedIdentity 매개 변수는 온-프레미스 Active Directory 사용자와 클라우드의 사용자를 연결합니다.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-FirstName

FirstName 매개 변수는 사용자의 이름을 지정합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ImmutableId

ImmutableId 매개 변수는 GAL 동기화(GALSync)에서 사용되며 SAML(Security Assertion Markup Language) 토큰을 요청할 때 페더레이션된 위임에 사용되는 Exchange 사서함에 대한 SMTP 주소 형식의 고유하고 변경할 수 없는 식별자를 지정합니다. 이 사서함에 대해 페더레이션이 구성되고 사서함을 만들 때 이 매개 변수를 설정하지 않으면 Exchange는 사서함의 ExchangeGUID 및 페더레이션된 계정 네임스페이스(예 7a78e7c8-620e-4d85-99d3-c90d90f29699@mail.contoso.com: )에 따라 변경할 수 없는 ID의 값을 만듭니다.

AD FS(Active Directory Federation Services)가 오프-프레미스 사서함에 Single Sign-On을 허용하도록 배포되고 AD FS가 로그온 토큰 요청에 ExchangeGUID와 다른 특성을 사용하도록 구성된 경우 ImmutableId 매개 변수를 설정해야 합니다. 둘 다 Exchange 및 AD FS는 크로스-프레미스 Exchange 배포 시나리오에 적절한 기능을 보장하기 위해 동일한 사용자에 대해 동일한 토큰을 요청해야 합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Initials

Initials 매개 변수는 사용자의 중간 이니셜을 지정합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-LastName

LastName 매개 변수는 사용자의 성을 지정합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MacAttachmentFormat

MacAttachmentFormat 매개 변수는 메일 연락처 또는 메일 사용자에게 보낸 메시지에 사용할 Apple Macintosh 운영 체제 첨부 파일 형식을 지정합니다. 유효한 값은 다음과 같습니다.

  • BinHex(기본값)
  • Uuencode
  • AppleSingle
  • AppleDouble

MacAttachmentFormat 및 MessageFormat 매개 변수는 상호 의존합니다.

  • MessageFormat은 텍스트: MacAttachmentFormat은 BinHex 또는 UuEncode일 수 있습니다.
  • MessageFormat은 Mime입니다. MacAttachmentFormat은 BinHex, AppleSingle 또는 AppleDouble일 수 있습니다.
Type:MacAttachmentFormat
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MailboxRegion

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-MessageBodyFormat

MessageBodyFormat 매개 변수는 메일 연락처 또는 메일 사용자에게 보낸 메시지의 메시지 본문 형식을 지정합니다. 유효한 값은 다음과 같습니다.

  • 텍스트
  • Html
  • Html

MessageFormat 및 MessageBodyFormat 매개 변수는 상호 의존합니다.

  • MessageFormat은 Mime입니다. MessageBodyFormat은 Text, Html 또는 TextAndHtml일 수 있습니다.
  • MessageFormat은 텍스트입니다. MessageBodyFormat은 텍스트일 수 있습니다.
Type:MessageBodyFormat
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MessageFormat

MessageFormat 매개 변수는 메일 연락처 또는 메일 사용자에게 보낸 메시지의 메시지 형식을 지정합니다. 유효한 값은 다음과 같습니다.

  • 텍스트
  • Text

MessageFormat 및 MessageBodyFormat 매개 변수는 상호 의존합니다.

  • MessageFormat은 Mime입니다. MessageBodyFormat은 Text, Html 또는 TextAndHtml일 수 있습니다.
  • MessageFormat은 텍스트입니다. MessageBodyFormat은 텍스트일 수 있습니다.

따라서 MessageFormat 매개 변수를 Mime에서 Text로 변경하려면 MessageBodyFormat 매개 변수도 Text로 변경해야 합니다.

Type:MessageFormat
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MicrosoftOnlineServicesID

MicrosoftOnlineServicesID 매개 변수는 개체의 사용자 ID를 지정합니다. 이 매개 변수는 클라우드 기반 서비스의 개체에만 적용됩니다. 온-프레미스 배포에는 사용할 수 없습니다.

Type:WindowsLiveId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-ModeratedBy

ModeratedBy 매개 변수는 이 받는 사람에 대한 하나 이상의 중재자를 지정합니다. 중재자는 메시지가 배달되기 전에 받는 사람에게 보낸 메시지를 승인합니다. 중재자는 조직의 사서함, 메일 사용자 또는 메일 연락처여야 합니다. 중재자를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예시:

  • 이름
  • 별칭
  • DN(고유 이름)
  • DN(고유 이름)
  • 정식 DN
  • GUID

Update 값에 공백이 포함되거나 따옴표가 필요한 경우 다음 구문을 "Value1","Value2",..."ValueN"사용합니다.

ModerationEnabled 매개 변수를 $true 값으로 설정할 때는 이 매개 변수를 사용하여 중재자를 한 명 이상 지정해야 합니다.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ModerationEnabled

ModerationEnabled 매개 변수는 이 수신자에 대해 조정을 사용할지 여부를 지정합니다. 사용할 수 있는 값은 다음과 같습니다.

  • $true: 이 수신자에 대해 조정이 사용됩니다. 이 수신자에게 전송된 메시지는 메시지가 전달되기 전에 중재자의 승인을 받아야 합니다.
  • $false: 이 수신자에 대해 조정을 사용할 수 없습니다. 이 수신자에게 전송되는 메시지는 중재자의 승인 없이 배달됩니다. 이 값은 기본값입니다.

ModeratedBy 매개 변수를 사용하여 중재자를 지정합니다.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Name

Name 매개 변수는 메일 사용자의 고유한 이름을 지정합니다. 최대 길이는 64자입니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

DisplayName 매개 변수를 사용하지 않는 경우 이 값은 DisplayName 속성에도 사용됩니다.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-OrganizationalUnit

OrganizationalUnit 매개 변수는 새 메일 사용자가 만들어지는 Active Directory의 위치를 지정합니다.

이 매개 변수에 대한 유효한 입력은 Get-OrganizationalUnit cmdlet에서 반환하는 OU(조직 구성 단위) 또는 도메인입니다. OU 또는 도메인을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

  • 이름
  • 이름
  • DN(고유 이름)
  • GUID
Type:OrganizationalUnitIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Password

Password 매개 변수는 사용자의 계정 암호를 지정합니다.

다음 메서드를 이 매개 변수의 값으로 사용할 수 있습니다.

  • (ConvertTo-SecureString -String '<password>' -AsPlainText -Force).
  • 이 명령을 실행하기 전에 암호를 변수(예 $password = Read-Host "Enter password" -AsSecureString: )로 저장한 다음 값에 변수($password)를 사용합니다.
  • (Get-Credential).password 이 명령을 실행할 때 암호를 안전하게 입력하라는 메시지가 표시됩니다.
Type:SecureString
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PrimarySmtpAddress

이 매개 변수는 온-프레미스 Exchange에서만 작동합니다.

PrimarySmtpAddress 매개 변수는 받는 사람에 대해 사용되는 기본 반환 전자 메일 주소를 지정합니다.

기본적으로 기본 주소는 ExternalEmailAddress 매개 변수 값과 같습니다.

PrimarySmtpAddress 매개 변수를 사용하여 기본 전자 메일 주소를 지정하는 경우 명령은 메일 사용자의 EmailAddressPolicyEnabled 속성을 False로 설정합니다. 즉, 메일 사용자의 전자 메일 주소가 전자 메일 주소 정책에 의해 자동으로 업데이트되지 않습니다. 크로스 포리스트 시나리오를 사용하는 경우가 아니면 ExternalEmailAddress 이외의 값으로 기본 전자 메일 주소를 설정하지 않는 것이 좋습니다.

Type:SmtpAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-RemotePowerShellEnabled

RemotePowerShellEnabled 매개 변수는 사용자가 원격 PowerShell을 사용하여 Exchange에 연결할 수 있는지 여부를 지정합니다. Exchange 서버에서 Exchange 관리 셸을 열거나 원격 PowerShell 세션을 열고 Exchange로 가져오는 Windows PowerShell 사용하려면 원격 PowerShell이 필요합니다. 로컬 Exchange 서버에서 Exchange 관리 셸을 열려고 하는 경우에도 원격 PowerShell에 액세스해야 합니다. 유효한 값은 다음과 같습니다.

  • $true: 사용자는 원격 PowerShell을 사용할 수 있습니다. 이 값은 기본값입니다.
  • $true: 사용자가 원격 PowerShell을 사용할 수 있습니다. 이 값은 기본값입니다.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ResetPasswordOnNextLogon

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

ResetPasswordOnNextLogon 매개 변수는 다음에 로그온할 때 사용자가 암호를 변경해야 하는지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

  • $true: 다음에 로그온할 때 암호를 변경해야 합니다.
  • $false: 사용자는 다음에 로그온할 때 암호를 변경할 필요가 없습니다. 이 값은 기본값입니다.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SamAccountName

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

SamAccountName 매개 변수(Windows 2000 이전의 사용자 계정 또는 그룹 이름으로도 알려져 있음)는 이전 버전의 Microsoft Windows 클라이언트 및 서버 운영 체제와 호환되는 개체 식별자를 지정합니다. 값은 문자, 숫자, 공백, 마침표(.) 및 다음 문자를 포함할 수 있습니다. !, #, $, %, ^, &, , -, _, {, }, ~. 마지막 문자로 마침표를 사용할 수 없습니다. 유니코드 문자는 허용되지만 악센트 부호 문자는 충돌할 수 있습니다(예: o 및 ö). 최대 길이는 20자입니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SendModerationNotifications

클라이언트 연결은 클라이언트 액세스 서비스에서 로컬 또는 원격 사서함 서버의 백 엔드 서비스로 프록시됩니다. 유효한 값은 다음과 같습니다.

  • 항상: 메시지가 승인되지 않은 경우 모든 보낸 사람에게 알립니다. 이 값은 기본값입니다.
  • Always: 메시지가 승인되지 않은 경우 보낸 사람 모두에게 알립니다. 이것이 기본값입니다.
  • Internal: 메시지가 승인되지 않은 경우 조직의 보낸 사람에게 알립니다.

이 매개 변수는 중재를 사용하는 경우에만 의미가 있습니다(ModerationEnabled 매개 변수에는 $true 값이 있음).

Type:TransportModerationNotificationFlags
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-UsePreferMessageFormat

UsePreferMessageFormat은 메일 사용자 또는 메일 연락처에 대해 구성된 메시지 형식 설정이 원격 도메인에 대해 구성된 전역 설정을 재정의하는지 또는 메시지 보낸 사람에서 구성했는지 여부를 지정합니다. 사용할 수 있는 값은 다음과 같습니다.

  • $true: 메일 사용자 또는 메일 연락처에 보낸 메시지는 메일 사용자 또는 메일 연락처에 대해 구성된 메시지 형식을 사용합니다.
  • $false: 메일 사용자 또는 메일 연락처에 보낸 메시지는 원격 도메인(기본 원격 도메인 또는 특정 원격 도메인)에 대해 구성되거나 메시지 보낸 사람에서 구성한 메시지 형식을 사용합니다. 이 값은 기본값입니다.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-UserPrincipalName

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

UserPrincipalName 매개 변수는 이메일 주소 형식(예 ed@contoso.com: )으로 시스템 사용자의 이름을 지정합니다.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

입력

Input types

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

출력

Output types

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