Update-AzADUser

참조

모듈:: Az.Resources

사용자의 엔터티를 업데이트합니다.

구문

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>]

Update-AzADUser
      [-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>]
      -ObjectId <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzADUser
      [-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>]
      -InputObject <IMicrosoftGraphUser>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzADUser
      [-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>]
      -UserPrincipalName <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

사용자의 엔터티를 업데이트합니다.

예제

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

Update-AzADUser -UPNOrObjectId $upn -City $city

사용자 계정 이름으로 사용자 업데이트

매개 변수

-AccountEnabled

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

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

-AgeGroup

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

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

-City

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

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

-CompanyName

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

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

-Confirm

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

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

-ConsentProvidedForMinor

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

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

-Country

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

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

-DefaultProfile

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

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

-DeletedDateTime

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

-Department

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

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

-DisplayName

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

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

-EmployeeHireDate

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

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

-EmployeeId

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

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

-EmployeeType

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

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

-ExternalUserState

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

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

-ExternalUserStateChangeDateTime

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

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

-FaxNumber

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

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

-ForceChangePasswordNextLogin

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

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

-GivenName

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

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

-Id

읽기 전용입니다.

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

-Identity

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

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

-InputObject

사용자 입력 개체

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

-IsResourceAccount

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

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

-JobTitle

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

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

-Mail

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

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

-MailNickname

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

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

-ObjectId

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

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

-OfficeLocation

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

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

-OnPremisesImmutableId

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

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

-OtherMail

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

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

-PassThru

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

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

-Password

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

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

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

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

-PasswordPolicy

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

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

-PasswordProfile

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

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

-PostalCode

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

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

-PreferredLanguage

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

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

-ShowInAddressList

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

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

-State

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

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

-StreetAddress

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

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

-Surname

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

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

-UPNOrObjectId

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

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

-UsageLocation

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

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

-UserPrincipalName

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

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

-UserType

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

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

-WhatIf

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

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

입력

IMicrosoftGraphUser

출력

Boolean

참고

별칭

Set-AzADUser

다음을 통해 공유