Set-AzureADUser

모듈:

AzureAD

사용자를 업데이트합니다.

구문

Set-AzureADUser
   -ObjectId <String>
   [-ExtensionProperty <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-AccountEnabled <Boolean>]
   [-AgeGroup <String>]
   [-City <String>]
   [-CompanyName <String>]
   [-ConsentProvidedForMinor <String>]
   [-Country <String>]
   [-CreationType <String>]
   [-Department <String>]
   [-DisplayName <String>]
   [-FacsimileTelephoneNumber <String>]
   [-GivenName <String>]
   [-IsCompromised <Boolean>]
   [-ImmutableId <String>]
   [-JobTitle <String>]
   [-MailNickName <String>]
   [-Mobile <String>]
   [-OtherMails <System.Collections.Generic.List`1[System.String]>]
   [-PasswordPolicies <String>]
   [-PasswordProfile <PasswordProfile>]
   [-PhysicalDeliveryOfficeName <String>]
   [-PostalCode <String>]
   [-PreferredLanguage <String>]
   [-ShowInAddressList <Boolean>]
   [-SignInNames <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.SignInName]>]
   [-State <String>]
   [-StreetAddress <String>]
   [-Surname <String>]
   [-TelephoneNumber <String>]
   [-UsageLocation <String>]
   [-UserPrincipalName <String>]
   [-UserState <String>]
   [-UserStateChangedOn <String>]
   [-UserType <String>]
   [<CommonParameters>]

Description

Set-AzureADUser cmdlet은 Azure AD(Active Directory)에서 사용자를 업데이트합니다.

예제

예제 1: 사용자 업데이트

PS C:\> $user = Get-AzureADUser -ObjectId TestUser@example.com 
PS C:\> $user.DisplayName = 'YetAnotherTestUser' 
PS C:\> Set-AzureADUser -ObjectId TestUser@example.com -Displayname $user.Displayname

예제 2: 지정된 사용자를 제외한 모든 사용자를 보호자 동의가 있는 미성년자로 설정

Get-AzureADUser -All $true | 
Where-Object -FilterScript { $_.DisplayName -notmatch '(George|James|Education)' } | 
ForEach-Object  { Set-AzureADUser -ObjectId $($_.ObjectId) -AgeGroup 'minor' -ConsentProvidedForMinor 'granted' }

이 명령은 지정된 사용자의 속성을 업데이트합니다.

매개 변수

-AccountEnabled

계정이 활성화되어 있는지 여부를 나타냅니다.

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

-AgeGroup

엔터프라이즈 애플리케이션에서 사용자의 법적 연령 그룹을 결정하는 데 사용됩니다. 이 속성은 읽기 전용이며 ageGroup 및 consentProvidedForMinor 속성을 기반으로 계산됩니다. 허용되는 값은 null, minor및 notAdult 입니다 adult. [법적 연령 그룹 속성 정의][연령 그룹 및 사소한 동의 정의에 대해 자세히 알아보기]를 참조하세요.

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

-City

사용자의 도시를 지정합니다.

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

-CompanyName

사용자가 연결된 회사 이름입니다. 이 속성은 외부 사용자가 온 회사를 설명하는 데 유용할 수 있습니다. 회사 이름의 최대 길이는 64자입니다.

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

-ConsentProvidedForMinor

미성년자에 대한 동의를 얻었는지 여부를 설정합니다. 허용되는 값은 null, granted및 denied 입니다 notRequired. 자세한 내용은 [법적 연령 그룹 속성 정의][연령 그룹 및 사소한 동의 정의에 대해 자세히 알아보기]를 참조하세요.

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

-Country

사용자의 국가 또는 지역을 지정합니다.

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

-CreationType

사용자 계정이 Azure Active Directory B2C 테넌트의 로컬 계정인지 여부를 나타냅니다. 가능한 값은 "LocalAccount" 및 null입니다. 로컬 계정을 만들 때 이 속성은 필수이며 "LocalAccount"로 설정해야 합니다. 회사 또는 학교 계정을 만들 때는 이 속성을 지정하지 않거나 null로 지정합니다.

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

-Department

사용자의 부서를 지정합니다.

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

-DisplayName

사용자의 표시 이름을 지정합니다.

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

-ExtensionProperty

사용자 지정 사용자 속성에 데이터를 기본 개방형 확장 또는 보다 다양한 스키마 확장으로 추가합니다. [확장에 대한 자세한 정보][확장에 대한 자세한 정보]를 참조하세요.

형식:	Dictionary<TKey,TValue>[System.String,System.String]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-FacsimileTelephoneNumber

사용자의 팩스 번호입니다.

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

-GivenName

사용자의 지정된 이름을 지정합니다.

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

-ImmutableId

이 속성은 온-프레미스 Active Directory 사용자 계정을 해당 Azure AD 사용자 개체에 연결하는 데 사용됩니다. UPN(사용자) 속성에 페더레이션된 도메인을 사용하는 경우 Graph에서 새 사용자 userPrincipalName 계정을 만들 때 이 속성을 지정해야 합니다. 중요: 이 속성을 지정할 때는 $ 및 _ 문자를 사용할 수 없습니다.

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

-IsCompromised

True이면 이 사용자가 손상되었습니다.

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

-JobTitle

사용자의 직항을 지정합니다.

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

-MailNickName

사용자의 메일 주소에 대한 애칭을 지정합니다.

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

-Mobile

사용자의 휴대폰 번호를 지정합니다.

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

-ObjectId

Azure AD에서 사용자의 ID(UPN 또는 ObjectId)를 지정합니다.

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

-OtherMails

사용자의 다른 전자 메일 주소를 지정합니다.

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

-PasswordPolicies

사용자에 대한 암호 정책을 지정합니다.

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

-PasswordProfile

사용자의 암호 프로필을 지정합니다.

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

-PhysicalDeliveryOfficeName

사용자 사업장의 사무실 위치입니다. 최대 길이는 128자입니다.

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

-PostalCode

사용자의 우편 번호를 지정합니다.

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

-PreferredLanguage

사용자의 기본 설정 언어를 지정합니다.

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

-ShowInAddressList

이 사용자를 주소 목록에 표시하려면 True로 설정합니다.

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

-SignInNames

이 사용자의 로그인 이름 목록

형식:	List<T>[Microsoft.Open.AzureAD.Model.SignInName]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-State

사용자의 상태를 지정합니다.

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

-StreetAddress

사용자의 거리 주소를 지정합니다.

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

-Surname

사용자의 성을 지정합니다.

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

-TelephoneNumber

사용자의 전화 번호를 지정합니다.

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

-UsageLocation

두 문자 국가 또는 지역 코드(ISO 표준 3166)입니다. 국가 및 지역의 서비스 가용성을 확인하기 위한 법적 요구 사항으로 인해 라이선스가 할당되는 사용자에게 필요합니다. "US", "JP" 및 "GB"를 예로 들 수 있습니다. Null을 허용하지 않습니다.

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

-UserPrincipalName

사용자의 사용자 계정 이름을 지정합니다.

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

-UserState

초대 API를 사용하여 테넌트로 초대된 외부 사용자의 경우 이 속성은 초대된 사용자의 초대 상태를 나타냅니다. 초대된 사용자의 경우 상태는 다른 모든 사용자에 대해 또는 Acceptednull 또는 일 PendingAcceptance 수 있습니다.

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

-UserStateChangedOn

externalUserState 속성에 대한 최신 변경에 대한 타임스탬프를 표시합니다.

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

-UserType

"Member", "Guest" 등 디렉터리의 사용자 유형을 분류하는 데 사용할 수 있는 문자열 값입니다.

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

참고

Microsoft Graph PowerShell 로의 Set-AzureADUser 마이그레이션 가이드 를 참조하세요.

관련 링크

• Get-AzureADUser
• New-AzureADUser
• Remove-AzureADUser