Update-AzADUser

구문

UPNOrObjectIdParameterSet (기본값)

Update-AzADUser
    -UPNOrObjectId <String>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ObjectIdParameterSet

Update-AzADUser
    -ObjectId <String>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectParameterSet

Update-AzADUser
    -InputObject <IMicrosoftGraphUser>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UPNParameterSet

Update-AzADUser
    -UserPrincipalName <String>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

예제

예제 1: 사용자 계정 이름으로 사용자 업데이트

Update-AzADUser -UPNOrObjectId $upn -City $city

매개 변수

-AccountEnabled

계정을 사용하도록 설정하기 위한 true입니다. 그렇지 않으면 false입니다. 와 결합된 경우 항상 true입니다 -Password. -AccountEnabled $false 는 계정의 암호를 변경할 때 무시됩니다.

매개 변수 속성

매개 변수 집합

-AgeGroup

사용자의 연령 그룹을 설정합니다. 허용되는 값: null, minor, notAdult 및 adult. 자세한 내용은 법적 연령 그룹 속성 정의를 참조하세요. $filter 지원합니다(eq, ne, NOT 및 in).

매개 변수 속성

매개 변수 집합

-City

사용자가 있는 도시입니다. 최대 길이는 128자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-CompanyName

사용자가 연결된 회사 이름입니다. 이 속성은 외부 사용자가 온 회사를 설명하는 데 유용할 수 있습니다. 회사 이름의 최대 길이는 64자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

매개 변수 속성

매개 변수 집합

-ConsentProvidedForMinor

미성년자에 대한 동의를 얻었는지 여부를 설정합니다. 허용되는 값: null, 허용, 거부 및 notRequired. 자세한 내용은 법적 연령 그룹 속성 정의를 참조하세요. $filter 지원합니다(eq, ne, NOT 및 in).

매개 변수 속성

매개 변수 집합

-Country

사용자가 있는 국가/지역입니다. 예를 들어 미국 또는 영국입니다. 최대 길이는 128자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

매개 변수 속성

매개 변수 집합

-DeletedDateTime

.

매개 변수 속성

매개 변수 집합

-Department

사용자가 작동하는 부서의 이름입니다. 최대 길이는 64자입니다. $filter 지원합니다(eq, ne, NOT, ge, le 및 in 연산자).

매개 변수 속성

매개 변수 집합

-DisplayName

사용자의 주소록에 표시되는 이름입니다. 이 값은 일반적으로 사용자의 이름, 중간 이니셜 및 성의 조합입니다. 이 속성은 사용자가 생성될 때 필요하며 업데이트 중에는 지울 수 없습니다. 최대 길이는 256자입니다. $filter(eq, ne, NOT, ge, le, in, startsWith), $orderBy 및 $search 지원합니다.

매개 변수 속성

매개 변수 집합

-EmployeeHireDate

사용자가 고용되었거나 향후 고용 시 작업을 시작할 날짜 및 시간입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in).

매개 변수 속성

매개 변수 집합

-EmployeeId

조직에서 사용자에게 할당한 직원 식별자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-EmployeeType

엔터프라이즈 작업자 유형을 캡처합니다. 예를 들어 직원, 계약자, 컨설턴트 또는 공급업체입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-ExternalUserState

초대 API를 사용하여 테넌트에 초대된 외부 사용자의 경우 이 속성은 초대된 사용자의 초대 상태를 나타냅니다. 초대된 사용자의 경우 상태는 PendingAcceptance 또는 Accepted이거나 다른 모든 사용자의 경우 null일 수 있습니다. $filter 지원합니다(eq, ne, NOT, in).

매개 변수 속성

매개 변수 집합

-ExternalUserStateChangeDateTime

externalUserState 속성에 대한 최신 변경 내용에 대한 타임스탬프를 표시합니다. $filter 지원합니다(eq, ne, NOT, in).

매개 변수 속성

매개 변수 집합

-FaxNumber

사용자의 팩스 번호입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-ForceChangePasswordNextLogin

사용자가 다음에 성공한 로그인(true)에서 암호를 변경해야 하는지 지정해야 합니다. 다음에 성공한 로그인에서 암호를 변경하지 않는 기본 동작은 (false)입니다.

매개 변수 속성

매개 변수 집합

-GivenName

사용자의 지정된 이름(이름)입니다. 최대 길이는 64자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-Id

읽기 전용.

매개 변수 속성

매개 변수 집합

-Identity

이 사용자 계정에 로그인하는 데 사용할 수 있는 ID를 나타냅니다. ID는 Microsoft(로컬 계정이라고도 함), 조직 또는 Facebook, Google 및 Microsoft와 같은 소셜 ID 공급자가 제공하고 사용자 계정에 연결할 수 있습니다. signInType 값이 같은 여러 항목을 포함할 수 있습니다. signInType이 userPrincipalName이 아닌 경우에만 $filter(eq)를 지원합니다. 생성하려면 IDENTITY 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

매개 변수 속성

매개 변수 집합

-InputObject

사용자 입력 개체

매개 변수 속성

매개 변수 집합

-IsResourceAccount

사용하지 마세요. 나중에 사용할 수 있습니다.

매개 변수 속성

매개 변수 집합

-JobTitle

사용자의 직호입니다. 최대 길이는 128자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-Mail

사용자의 SMTP 주소입니다(예: .) admin@contoso.com. 이 속성을 변경하면 값을 SMTP 주소로 포함하도록 사용자의 proxyAddresses 컬렉션도 업데이트됩니다. 이 속성은 악센트 문자를 포함할 수 있지만, 이 문자를 사용하면 사용자에 대한 다른 Microsoft 애플리케이션에 액세스 문제가 발생할 수 있습니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith, endsWith).

매개 변수 속성

매개 변수 집합

-MailNickname

사용자의 메일 별칭입니다. 이 속성은 사용자를 만들 때 지정해야 합니다. 최대 길이는 64자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-ObjectId

업데이트할 사용자의 사용자 계정 이름입니다.

매개 변수 속성

매개 변수 집합

-OfficeLocation

사용자의 비즈니스 위치에 있는 사무실 위치입니다. 최대 길이는 128자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-OnPremisesImmutableId

이 속성은 온-프레미스 Active Directory 사용자 계정을 해당 Azure AD 사용자 개체에 연결하는 데 사용됩니다. 사용자의 UPN(userPrincipalName) 속성에 페더레이션된 도메인을 사용하는 경우 Graph에서 새 사용자 계정을 만들 때 이 속성을 지정해야 합니다. 참고: 이 속성을 지정할 때 $ 및 _ 문자를 사용할 수 없습니다. $select만 반환됩니다. $filter 지원합니다(eq, ne, NOT, ge, le, in).

매개 변수 속성

매개 변수 집합

-OtherMail

사용자의 추가 전자 메일 주소 목록입니다. 예: [''bob@contoso.com, 'Robert@fabrikam.com']. 참고: 이 속성에는 악센트 문자를 포함할 수 있지만 사용자의 자사 애플리케이션에 대한 액세스 문제가 발생할 수 있습니다. $filter 지원합니다(eq, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-PassThru

명령이 성공하면 true를 반환합니다.

매개 변수 속성

매개 변수 집합

-Password

사용자의 암호입니다. 이 속성은 사용자를 만들 때 필요합니다.

업데이트할 수 있지만 사용자는 다음 로그인에서 암호를 변경해야 합니다.

암호는 사용자의 passwordPolicies 속성에 지정된 최소 요구 사항을 충족해야 합니다. 기본적으로 강력한 암호가 필요합니다. 이 방법을 사용하여 암호를 변경할 때 AccountEnabled는 true로 설정됩니다.

매개 변수 속성

매개 변수 집합

-PasswordPolicy

사용자에 대한 암호 정책을 지정합니다. 이 값은 기본 정책보다 약한 암호를 지정할 수 있는 DisableStrongPassword 값이 하나 있는 열거형입니다. DisablePasswordExpiration도 지정할 수 있습니다. 두 가지를 함께 지정할 수 있습니다. 예: DisablePasswordExpiration, DisableStrongPassword.Supports $filter(ne, NOT).

매개 변수 속성

매개 변수 집합

-PasswordProfile

passwordProfile 생성하려면 PASSWORDPROFILE 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

매개 변수 속성

매개 변수 집합

-PostalCode

사용자의 우편 주소에 대한 우편 번호입니다. 우편 번호는 사용자의 국가/지역과 관련이 있습니다. 미국에서는 이 특성에 우편 번호가 포함됩니다. 최대 길이는 40자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-PreferredLanguage

사용자의 기본 설정 언어입니다. ISO 639-1 코드를 따라야 합니다. 예를 들어 en-US. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-ShowInAddressList

Outlook 전역 주소 목록에 이 사용자가 포함되어야 하면 true이고, 그렇지 않으면 false입니다. 설정하지 않으면 true로 처리됩니다. 초대 관리자를 통해 초대된 사용자의 경우 이 속성은 false로 설정됩니다. $filter 지원합니다(eq, ne, NOT, in).

매개 변수 속성

매개 변수 집합

-State

사용자의 주소에 있는 주 또는 주입니다. 최대 길이는 128자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-StreetAddress

사용자 비즈니스 위치의 거리 주소입니다. 최대 길이는 1024자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-Surname

사용자의 성(가족 이름 또는 성)입니다. 최대 길이는 64자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-UPNOrObjectId

업데이트할 사용자의 사용자 계정 이름 또는 개체 ID입니다.

매개 변수 속성

매개 변수 집합

-UsageLocation

두 문자 국가 코드(ISO 표준 3166)입니다. 국가의 서비스 가용성을 확인하기 위한 법적 요구 사항으로 인해 라이선스가 할당되는 사용자에게 필요합니다. 예를 들어 미국, JP 및 GB가 있습니다. Null을 허용하지 않습니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-UserPrincipalName

사용자의 UPN(사용자 계정 이름)입니다. UPN은 인터넷 표준 RFC 822를 기반으로 하는 사용자의 인터넷 스타일 로그인 이름입니다. 규칙에 따라 사용자의 전자 메일 이름에 매핑됩니다. 일반 형식은 alias@domain. 여기서 도메인은 테넌트의 확인된 도메인 컬렉션에 있어야 합니다. 이 속성은 사용자를 만들 때 필요합니다. 테넌트에 대해 확인된 도메인은 조직의 verifiedDomains 속성에서 액세스할 수 있습니다. 참고: 이 속성에는 악센트 문자를 포함할 수 있지만 사용자의 자사 애플리케이션에 대한 액세스 문제가 발생할 수 있습니다. $filter(eq, ne, NOT, ge, le, in, startsWith, endsWith) 및 $orderBy 지원합니다.

매개 변수 속성

매개 변수 집합

-UserType

멤버 및 게스트와 같은 디렉터리에서 사용자 형식을 분류하는 데 사용할 수 있는 문자열 값입니다. $filter 지원합니다(eq, ne, NOT, in,).

매개 변수 속성

매개 변수 집합

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

매개 변수 집합

CommonParameters

입력

IMicrosoftGraphUser

출력

Boolean

참고