Set-User

모듈:

ExchangePowerShell

적용 대상:

Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

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

Set-User cmdlet을 사용하여 사용자 특성을 수정합니다. 이 cmdlet을 사용하여 사용자 계정이 있는 모든 개체(예: 사용자 사서함, 메일 사용자 및 사용자 계정)를 수정할 수 있습니다.

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

Syntax

Set-User
   [-Identity] <UserIdParameter>
   [-AllowUMCallsFromNonUsers <AllowUMCallsFromNonUsersFlags>]
   [-Arbitration]
   [-AssistantName <String>]
   [-AuthenticationPolicy <String>]
   [-BlockCloudCache <Boolean>]
   [-CanHaveCloudCache <Boolean>]
   [-CertificateSubject <MultiValuedProperty>]
   [-City <String>]
   [-ClearDataEncryptionPolicy]
   [-Company <String>]
   [-Confirm]
   [-CountryOrRegion <CountryInfo>]
   [-CreateDTMFMap <Boolean>]
   [-Department <String>]
   [-DesiredWorkloads <MailboxWorkloadFlags>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-Fax <String>]
   [-FirstName <String>]
   [-Force]
   [-GeoCoordinates <GeoCoordinates>]
   [-HomePhone <String>]
   [-IgnoreDefaultScope]
   [-Initials <String>]
   [-LastName <String>]
   [-LinkedCredential <PSCredential>]
   [-LinkedDomainController <String>]
   [-LinkedMasterAccount <UserIdParameter>]
   [-MailboxRegion <String>]
   [-MailboxRegionSuffix <MailboxRegionSuffixValue>]
   [-Manager <UserContactIdParameter>]
   [-MobilePhone <String>]
   [-Name <String>]
   [-Notes <String>]
   [-Office <String>]
   [-OtherFax <MultiValuedProperty>]
   [-OtherHomePhone <MultiValuedProperty>]
   [-OtherTelephone <MultiValuedProperty>]
   [-Pager <String>]
   [-PermanentlyClearPreviousMailboxInfo]
   [-Phone <String>]
   [-PhoneticDisplayName <String>]
   [-PostalCode <String>]
   [-PostOfficeBox <MultiValuedProperty>]
   [-PublicFolder]
   [-RemotePowerShellEnabled <Boolean>]
   [-RemoveMailboxProvisioningConstraint]
   [-ResetPasswordOnNextLogon <Boolean>]
   [-SamAccountName <String>]
   [-SeniorityIndex <Int32>]
   [-SimpleDisplayName <String>]
   [-SkipDualWrite]
   [-StateOrProvince <String>]
   [-StreetAddress <String>]
   [-StsRefreshTokensValidFrom <DateTime>]
   [-TelephoneAssistant <String>]
   [-Title <String>]
   [-UMCallingLineIds <MultiValuedProperty>]
   [-UMDtmfMap <MultiValuedProperty>]
   [-UserPrincipalName <String>]
   [-VIP <Boolean>]
   [-WebPage <String>]
   [-WhatIf]
   [-WindowsEmailAddress <SmtpAddress>]
   [<CommonParameters>]

Description

Set-User cmdlet에는 사서함 또는 메일 사용자에 대한 메일 관련 속성이 없습니다. 사용자의 메일 관련 속성을 수정하려면 개체 유형(예: Set-Mailbox 또는 Set-MailUser)에 따라 해당 cmdlet을 사용해야 합니다.

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

예제

예 1

Set-User -Identity Contoso\Jill -DisplayName "Jill Frank"

이 예에서는 사용자 Jill Frank의 표시 이름을 설정합니다.

예 2

Set-User -Identity Kweku@fabrikam.com -LinkedMasterAccount $null

다음은 LinkedMasterAccount 매개 변수를 $null 설정하여 연결된 사서함 Kweku@fabrikam.com 의 연결을 해제하고 사용자 사서함으로 변환하는 예제입니다.

연결된 사서함에서 이 절차를 수행하면 다른 이름으로 보내기, 모든 액세스, 폴더 및 일정 위임과 같은 사서함에 대한 모든 권한이 제거됩니다.

매개 변수

-AllowUMCallsFromNonUsers

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

AllowUMCallsFromNonUsers 매개 변수는 통합 메시징 디렉터리 검색에서 사용자를 제외할지 여부를 지정합니다.

Type:	AllowUMCallsFromNonUsersFlags
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

-Arbitration

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

중재 사서함을 수정하려면 중재 스위치가 필요합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

중재 사서함은 다양한 유형의 시스템 데이터를 저장하고 메시징 승인 워크플로를 관리하는 데 사용되는 시스템 사서함입니다.

Type:	SwitchParameter
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

-AssistantName

AssistantName 매개 변수는 사용자의 도우미 이름을 지정합니다.

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

-AuthenticationPolicy

AuthenticationPolicy 매개 변수는 사용자에게 적용할 인증 정책을 지정합니다. 정책을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

• 이름
• DN(고유 이름)
• GUID

사용자에 대한 정책 할당을 제거하려면 값 $null 사용합니다.

New-AuthenticationPolicy cmdlet을 사용하여 인증 정책을 만들어 기본 인증 또는 (Exchange 2019 CU2 이상에서) 기타 레거시 인증 방법을 차단하거나 선택적으로 허용합니다.

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

-BlockCloudCache

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

{{ Fill BlockCloudCache Description }}

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

-CanHaveCloudCache

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

{{ Fill CanHaveCloudCache Description }}

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

-CertificateSubject

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

CertificateSubject 매개 변수는 사용자 디지털 인증서의 제목 필드 값을 지정합니다.

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

-City

City 매개 변수는 사용자의 구/군/시를 지정합니다.

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

-ClearDataEncryptionPolicy

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

{{ Fill ClearDataEncryptionPolicy Description }}

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

-Company

Company 매개 변수는 사용자의 회사를 지정합니다.

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

-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

-CountryOrRegion

CountryOrRegion 매개 변수는 사용자의 국가나 지역을 지정합니다. 유효한 값은 유효한 ISO 3166-1 두 글자 국가 코드(예: 오스트레일리아의 경우 AU) 또는 해당 국가의 해당 식별 이름입니다(공식 ISO 3166 유지 관리 기관 짧은 이름과 다를 수 있음).

두 글자로 된 국가 코드에 대한 참조는 국가 코드 목록에서 사용할 수 있습니다.

식별 이름은 Get-User cmdlet에 의해 CountryOrRegion 속성 값에 반환되지만 필터 작업에서 식별 이름 또는 두 글자로 된 국가 코드를 사용할 수 있습니다.

Type:	CountryInfo
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

-CreateDTMFMap

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

CreateDTMFMap 매개 변수는 받는 사람에 대한 이중 톤 DTMF(다중 주파수) 맵을 만들지 여부를 지정합니다. 이렇게 하면 UM(통합 메시징) 환경에서 전화 키패드를 사용하여 받는 사람을 식별할 수 있습니다. 유효한 값은 다음과 같습니다.

• $true: 받는 사람에 대한 DTMF 맵이 만들어집니다. 이 값은 기본값입니다.
• $true: 받는 사람에 대해 DTMF 맵이 만들어집니다. 이 값은 기본값입니다.

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

-Department

Department 매개 변수는 사용자의 부서를 지정합니다.

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

-DesiredWorkloads

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

{{ DesiredWorkloads 설명 입력 }}

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

-DisplayName

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

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

-Fax

Fax 매개 변수는 사용자의 팩스 번호를 지정합니다.

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

-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

-Force

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

강제 스위치는 경고 또는 확인 메시지를 숨깁니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

관리 입력에 대한 확인 메시지를 표시하는 것이 부적절한 경우 이 스위치를 사용하여 작업을 프로그래밍 방식으로 실행할 수 있습니다.

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

-GeoCoordinates

GeoCoordinates 매개 변수는 사용자의 위치를 위도, 경도 및 (선택 사항) 고도 좌표로 지정합니다. 이 매개 변수의 유효한 값은 다음 형식 중 하나를 사용합니다.

• 위도 및 경도: 예를 들어 "47.644125;-122.122411"
• 위도, 경도 및 고도: 예를 들어 "47.644125;-122.122411;161.432"

참고: 마침표 구분 기호가 작동하지 않는 경우 대신 쉼표 를 사용합니다.

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

-HomePhone

HomePhone 매개 변수는 사용자의 집 전화 번호를 지정합니다.

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

-Identity

Identity 매개 변수는 수정하려는 사용자를 지정합니다. 사용자를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예시:

• 이름
• UPN(사용자 계정 이름)
• DN(고유 이름)
• DN(고유 이름)
• GUID
• UserPrincipalName

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

-IgnoreDefaultScope

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

IgnoreDefaultScope 스위치는 명령에 Exchange PowerShell 세션에 대한 기본 수신자 scope 설정을 무시하고 전체 포리스트를 scope 사용하도록 지시합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치를 사용하면 명령이 기본 scope 현재 사용할 수 없는 Active Directory 개체에 액세스할 수 있지만 다음과 같은 제한 사항도 도입됩니다.

• DomainController 매개 변수는 사용할 수 없습니다. 명령은 자동으로 적절한 글로벌 카탈로그 서버를 사용합니다.
• DomainController 매개 변수는 사용할 수 없습니다. 명령은 자동으로 적절한 글로벌 카탈로그 서버를 사용합니다.

Type:	SwitchParameter
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

-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

-LinkedCredential

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

LinkedCredential 매개 변수는 LinkedDomainController 매개 변수로 지정된 도메인 컨트롤러에 액세스하는 데 사용되는 사용자 이름과 암호를 지정합니다.

이 매개 변수의 값에는 Get-Credential cmdlet이 있어야 합니다. 이 명령을 일시 중지 하고 자격 증명을 입력 하라는 메시지가 표시 되면 (Get-Credential)값을 사용 합니다. 또는이 명령을 실행 하기 전에 자격 증명을 변수에 저장 (예: $cred = Get-Credential) 한 다음이 매개 변수에 대 한 변수 이름 ($cred)을 사용 합니다. 자세한 내용은 Get-Credential을 참조하세요.

LinkedCredential 매개 변수는 반드시 연결된 사용자와 함께 사용해야 합니다.

Type:	PSCredential
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

-LinkedDomainController

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

LinkedDomainController 매개 변수는 이 사용자가 연결된 사용자인 경우 사용자 계정이 있는 포리스트의 도메인 컨트롤러를 지정합니다. 사용자 계정이 있는 포리스트의 도메인 컨트롤러를 사용하여 LinkedMasterAccount 매개 변수에서 지정한 계정에 대한 보안 정보를 가져오는 데 사용됩니다.

이 매개 변수는 연결된 사용자에 연결하는 경우에만 필요합니다.

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

-LinkedMasterAccount

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

LinkedMasterAccount 매개 변수는 이 사용자가 연결된 사용자인 경우 사용자 계정이 있는 포리스트의 master 계정을 지정합니다. master 계정은 사용자가 연결하는 계정입니다. master 계정은 사용자에게 액세스 권한을 부여합니다. 다음 값 중 하나를 사용할 수 있습니다.

• GUID
• Dn
• Domain\Account
• UPN
• LegacyExchangeDN
• SmtpAddress
• 별칭
• $null

이 매개 변수 값을 $null로 설정하면 계정 연결이 끊어지고 연결된 사서함이 연결되지 않은 사용자 사서함으로 변환됩니다. 이 사서함은 다른 사람 이름으로 보내기, 모든 권한, 폴더 및 일정 위임과 같은 이전에 설정된 권한이 유지되지 않습니다.

이 매개 변수는 연결된 사용자에 연결하는 경우에만 필요합니다.

Type:	UserIdParameter
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

-MailboxRegion

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

{{ Fill MailboxRegion Description }}

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

-MailboxRegionSuffix

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

{{ Fill MailboxRegionSuffix description }}

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

-Manager

Manager 매개 변수는 사용자의 관리자를 지정합니다.

Type:	UserContactIdParameter
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

-MobilePhone

MobilePhone 매개 변수는 사용자의 기본 휴대폰 번호를 지정합니다.

참고: Exchange Online 이 매개 변수는 사용할 수 없습니다. 대신 Microsoft Graph PowerShell의 Update-MgUser cmdlet에서 MobilePhone 매개 변수를 사용합니다.

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

-Name

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

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

-Notes

Notes 매개 변수는 개체에 대한 추가 정보를 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

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

-Office

Office 매개 변수는 사용자의 실제 사무실 이름 또는 번호를 지정합니다.

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

-OtherFax

OtherFax 매개 변수는 사용자의 대체 팩스 번호를 지정합니다.

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

-OtherHomePhone

OtherHomePhone 매개 변수는 사용자의 대체 집 전화 번호를 지정합니다.

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

-OtherTelephone

OtherTelephone 매개 변수는 사용자의 대체 전화 번호를 지정합니다.

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

-Pager

Pager 매개 변수는 사용자의 호출기 번호를 지정합니다.

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

-PermanentlyClearPreviousMailboxInfo

이 매개 변수는 온-프레미스 Exchange에서 사용할 수 없거나 작동하지 않습니다. Exchange Online만 사용할 수 있습니다.

PermanentlyClearPreviousMailboxInfo 스위치는 사용자의 Exchange Online 사서함 특성을 지울지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

온-프레미스 Exchange와 Microsoft 365 간의 사서함 이동 및 다시 라이선스 시나리오에서 이러한 특성을 지우는 것이 필요할 수 있습니다. 자세한 내용은 이전 사서함 정보 영구적으로 지우기 를 참조하세요.

주의: 이 스위치는 기존 클라우드 사서함 및 관련 보관 파일을 영구적으로 삭제하고 사서함에 다시 연결하지 못하게 하며 사서함에서 콘텐츠를 복구하지 못하게 합니다.

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

-Phone

Phone 매개 변수는 사용자의 사무실 전화 번호를 지정합니다.

참고: Exchange Online 이 매개 변수는 사용할 수 없습니다. 대신 Microsoft Graph PowerShell의 Update-MgUser cmdlet에서 BusinessPhones 매개 변수를 사용합니다.

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

-PhoneticDisplayName

PhoneticDisplayName 매개 변수는 UM(통합 메시징) 환경에서 텍스트-음성 변환에 사용되는 사용자 이름의 대체 철자를 지정합니다. 일반적으로 사용자 이름의 발음과 철자가 일치하지 않는 경우 이 매개 변수를 사용하면 됩니다. 최대 길이는 256자입니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

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

-PostalCode

PostalCode 매개 변수는 사용자의 우편 번호를 지정합니다.

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

-PostOfficeBox

PostOfficeBox 매개 변수는 사용자의 사서함 번호를 지정합니다.

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

-PublicFolder

공용 폴더 사서함을 수정하려면 PublicFolder 스위치가 필요합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

공용 폴더 사서함은 공용 폴더의 계층 구조와 콘텐츠를 저장하는 특별히 설계된 사서함입니다.

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

-RemotePowerShellEnabled

RemotePowerShellEnabled 매개 변수는 사용자가 원격 PowerShell에 액세스할 수 있는지 여부를 지정합니다. 로컬 사서함 서버에서 Exchange 관리 셸 또는 EAC를 열려고 하는 경우에도 Exchange 관리 셸 또는 EAC(Exchange 관리 센터)를 열려면 원격 PowerShell 액세스가 필요합니다. 유효한 값은 다음과 같습니다.

• $true: 사용자가 원격 PowerShell에 액세스할 수 있습니다.
• $false: 사용자는 원격 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

-RemoveMailboxProvisioningConstraint

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

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

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

-ResetPasswordOnNextLogon

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, Exchange Online, Exchange Online Protection

-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

-SeniorityIndex

SeniorityIndex 매개 변수는 이 사용자가 계층 구조 주소록에 표시되는 순서를 지정합니다. 주소록에서 값이 2인 사용자는 값이 1인 사용자보다 위쪽에 표시됩니다.

Type:	Int32
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

-SimpleDisplayName

SimpleDisplayName 매개 변수는 제한된 문자 집합만 허용되는 경우 개체에 대한 대체 설명을 표시하는 데 사용됩니다. 유효한 문자는 다음과 같습니다.

• SimpleDisplayName 매개 변수는 제한된 문자 집합만 허용되는 경우 개체에 대한 대체 설명을 표시하는 데 사용됩니다. 사용할 수 있는 문자는 다음과 같습니다.
• a – z
• A – Z
• 공백
• " ' ( ) + , - . / : ?

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

-SkipDualWrite

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

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

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

-StateOrProvince

StateOrProvince 매개 변수는 사용자의 시/도를 지정합니다.

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

-StreetAddress

StreetAddress 매개 변수는 사용자의 실제 주소를 지정합니다.

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

-StsRefreshTokensValidFrom

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

StsRefreshTokensValidFrom은 사용자의 STS 새로 고침 토큰이 유효한 날짜 시간을 지정합니다.

명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 mm/dd/yyyy의 간단한 날짜 형식을 사용하도록 컴퓨터가 구성된 경우 09/01/2018를 입력하여 2018년 9월 1일을 지정할 수 있습니다. 날짜만 입력하거나 날짜와 시간을 입력할 수도 있습니다. 날짜와 시간을 입력하는 경우 큰따옴표(")로 값을 묶어야 합니다. 예: "09/01/2018 5:00 PM".

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

-TelephoneAssistant

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

TelephoneAssistant 매개 변수는 사용자의 도우미 전화 번호를 지정합니다.

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

-Title

Title 매개 변수는 사용자의 직함을 지정합니다.

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

-UMCallingLineIds

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

UMCallingLineIds 매개 변수는 UM(통합 메시징) 사용 가능 사용자에게 매핑할 수 있는 전화 번호 또는 내선을 지정합니다. 각 사용자에 대해 두 개 이상의 전화 번호를 쉼표로 구분하여 지정할 수 있습니다. 이 매개 변수에는 길이가 128자 미만인 숫자를 사용할 수 있으며 숫자 앞에 선택적 더하기 기호(+)를 포함할 수 있습니다. UM 사용 가능한 각 사용자는 고유한 UMCallingLineIds 매개 변수 값을 사용해야 합니다.

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

-UMDtmfMap

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

UMDtmfMap 매개 변수는 받는 사람에 대한 이중 톤 DTMF(다중 주파수) 맵 값을 지정합니다. 이렇게 하면 UM(통합 메시징) 환경에서 전화 키패드를 사용하여 받는 사람을 식별할 수 있습니다. 일반적으로 이러한 DTMF 값은 자동으로 만들어지고 업데이트되지만 이 매개 변수를 사용하여 수동으로 변경할 수 있습니다. 이 매개 변수에는 다음 구문을 사용할 수 있습니다.

• emailAddress:<integers>
• lastNameFirstName:<integers>
• firstNameLastName:<integers>

모든 기존 항목을 덮어쓰는 값을 입력하려면 구문을 emailAddress:<integers>,lastNameFirstName:<integers>,firstNameLastName:<integers>사용합니다.

이 구문을 사용하고 DTMF 맵 값을 생략하면 해당 값이 받는 사람에서 제거됩니다. 예를 들어 만 지정 emailAddress:<integers>하면 기존의 모든 lastNameFirstName 및 firstNameLastName 값이 제거됩니다.

다른 기존 항목에 영향을 주지 않고 값을 추가하거나 제거하려면 구문을 @{Add="emailAddress:<integers>","lastNameFirstName:<integers>","firstNameLastName:<integers>"; Remove="emailAddress:<integers>","lastNameFirstName:<integers>","firstNameLastName:<integers>"}사용합니다.

이 구문을 사용하는 경우 모든 DTMF 맵 값을 지정할 필요가 없으며 여러 DTMF 맵 값을 지정할 수 있습니다. 예를 들어 를 사용하여 @{Add="emailAddress:<integers1>","emailAddress:<integers2>} 기존 lastNameFirstName 및 firstNameLastName 값에 영향을 주지 않고 emailAddress에 대해 두 개의 새 값을 추가할 수 있습니다.

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

-UserPrincipalName

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

UserPrincipalName 매개 변수는 사용자의 로그온 이름을 지정합니다. UPN은 이메일 주소 형식 username@domain을 사용합니다. 일반적으로 도메인 값은 사용자 계정이 있는 도메인입니다.

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

-VIP

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

VIP 매개 변수는 사용자가 우선 순위 계정인지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

• $true: 사용자가 우선 순위 계정입니다.
• $false: 사용자가 우선 순위 계정이 아닙니다.

우선 순위 계정에 대한 자세한 내용은 우선 순위 계정 관리 및 모니터링을 참조하세요.

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

-WebPage

WebPage 매개 변수는 사용자의 웹 페이지를 지정합니다.

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

-WhatIf

WhatIf 스위치가 이 cmdlet에서 작동하지 않습니다.

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

-WindowsEmailAddress

WindowsEmailAddress 매개 변수는 이 받는 사람의 Windows 전자 메일 주소를 지정합니다. Exchange가 없는 환경을 포함하여 모든 환경에 있는 일반적인 Active Directory 특성입니다. 받는 사람에서 WindowsEmailAddress 매개 변수를 사용하면 다음 결과 중 하나가 있습니다.

• 받는 사람이 전자 메일 주소 정책(EmailAddressPolicyEnabled 속성이 받는 사람의 경우 True 값으로 설정됨)이 적용되는 환경에서 WindowsEmailAddress 매개 변수는 WindowsEmailAddress 속성 또는 기본 메일 주소 값에 영향을 주지 않습니다.
• 받는 사람이 전자 메일 주소 정책의 적용을 받지 않는 환경에서(EmailAddressPolicyEnabled 속성이 받는 사람의 경우 False 값으로 설정됨) WindowsEmailAddress 매개 변수는 WindowsEmailAddress 속성과 기본 메일 주소 동일한 값으로 업데이트합니다.

WindowsEmailAddress 속성은 전자 메일 특성의 Active Directory 사용자 및 컴퓨터에서 받는 사람에 대해 표시됩니다. 특성 일반 이름은 전자 메일 주소이고 Ldap-Display-Name은 메일입니다. Active Directory에서 이 특성을 수정하면 받는 사람의 기본 메일 주소 동일한 값으로 업데이트되지 않습니다.

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

입력

Input types

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

출력

Output types

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