Set-AzureADUser
사용자를 업데이트합니다.
Syntax
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
계정이 활성화되어 있는지 여부를 나타냅니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AgeGroup
엔터프라이즈 애플리케이션에서 사용자의 법적 연령 그룹을 결정하는 데 사용됩니다. 이 속성은 읽기 전용이며 ageGroup 및 consentProvidedForMinor 속성에 따라 계산됩니다. 허용되는 값: null, minor및 notAdultadult. [법적 연령 그룹 속성 정의][연령 그룹 및 사소한 동의 정의에 대해 자세히 알아보기]를 참조하세요.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-City
사용자의 도시를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CompanyName
사용자가 연결된 회사 이름입니다. 이 속성은 외부 사용자가 온 회사를 설명하는 데 유용할 수 있습니다. 회사 이름의 최대 길이는 64자입니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConsentProvidedForMinor
미성년자에 대한 동의를 얻었는지 여부를 설정합니다. 허용되는 값: null, granted및 deniednotRequired. 자세한 내용은 [법적 연령 그룹 속성 정의][연령 그룹 및 사소한 동의 정의에 대해 자세히 알아보기]를 참조하세요.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Country
사용자의 국가 또는 지역을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CreationType
사용자 계정이 Azure Active Directory B2C 테넌트의 로컬 계정인지 여부를 나타냅니다. 가능한 값은 "LocalAccount" 및 null입니다. 로컬 계정을 만들 때 이 속성은 필수이며 "LocalAccount"로 설정해야 합니다. 회사 또는 학교 계정을 만들 때는 이 속성을 지정하지 않거나 null로 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Department
사용자의 부서를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisplayName
사용자의 표시 이름을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExtensionProperty
사용자 지정 사용자 속성에 데이터를 기본 개방형 확장 또는 보다 다양한 스키마 확장으로 추가합니다. [확장에 대한 자세한 정보][확장에 대한 자세한 정보]를 참조하세요.
| Type: | Dictionary<TKey,TValue>[System.String,System.String] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FacsimileTelephoneNumber
사용자의 팩스 번호입니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-GivenName
사용자의 지정된 이름을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ImmutableId
이 속성은 온-프레미스 Active Directory 사용자 계정을 해당 Azure AD 사용자 개체에 연결하는 데 사용됩니다. UPN(사용자) 속성에 페더레이션된 도메인을 사용하는 경우 Graph에서 새 사용자 userPrincipalName 계정을 만들 때 이 속성을 지정해야 합니다. 중요: 이 속성을 지정할 때는 $ 및 _ 문자를 사용할 수 없습니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsCompromised
이 사용자가 손상된 경우 True
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobTitle
사용자의 직항을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MailNickName
사용자의 메일 주소에 대한 애칭을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Mobile
사용자의 휴대폰 번호를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ObjectId
Azure AD 사용자의 ID(UPN 또는 ObjectId)를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OtherMails
사용자의 다른 전자 메일 주소를 지정합니다.
| Type: | List<T>[String] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PasswordPolicies
사용자에 대한 암호 정책을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PasswordProfile
사용자의 암호 프로필을 지정합니다.
| Type: | PasswordProfile |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PhysicalDeliveryOfficeName
사용자 사업장의 사무실 위치입니다. 최대 길이는 128자입니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PostalCode
사용자의 우편 번호를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PreferredLanguage
사용자의 기본 설정 언어를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ShowInAddressList
이 사용자를 주소 목록에 표시하려면 True로 설정합니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SignInNames
이 사용자의 로그인 이름 목록
| Type: | List<T>[Microsoft.Open.AzureAD.Model.SignInName] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-State
사용자의 상태를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StreetAddress
사용자의 거리 주소를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Surname
사용자의 성을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TelephoneNumber
사용자의 전화 번호를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UsageLocation
두 문자 국가 또는 지역 코드(ISO 표준 3166)입니다. 국가 및 지역의 서비스 가용성을 검사 법적 요구 사항으로 인해 라이선스가 할당되는 사용자에게 필요합니다. "US", "JP" 및 "GB"를 예로 들 수 있습니다. Null을 허용하지 않습니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserPrincipalName
사용자의 사용자 계정 이름을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserState
초대 API를 사용하여 테넌트로 초대된 외부 사용자의 경우 이 속성은 초대된 사용자의 초대 상태 나타냅니다. 초대된 사용자의 경우 상태는 또는 또는 또는 Acceptednull 다른 모든 사용자에 대한 상태가 될 PendingAcceptance 수 있습니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserStateChangedOn
externalUserState 속성에 대한 최신 변경 내용에 대한 타임스탬프를 표시합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserType
"Member", "Guest" 등 디렉터리의 사용자 유형을 분류하는 데 사용할 수 있는 문자열 값입니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
참고
Microsoft Graph PowerShell 로의 Set-AzureADUser 마이그레이션 가이드 를 참조하세요.
관련 링크
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기