[Powershell 3] Office 365 사용자 관리(조회 및 등록)

Powershell을 이용한 Office 365 관리 세번째로 사용자 조회와 등록을 중점적으로 다루겠습니다. 사용자 조회와 등록은 2가지 명령어(Get-MsolUser, New-MsolUser)를 사용하며 상세한 옵션은 글하단 참조 사이트를 방문하시면 상세한 정보를 확인하실 수 있습니다.

사용자 조회

사용자 조회는 기본적으로 Get-MsolUser 명령어를 사용합니다. -All 옵션은 넣지 않아도 결과는 동일합니다.

# 사용자 조회 Get-MsolUser # 모든 사용자 조회 -All 옵션 Get-MsolUser -All

특정 사용자 및 특정 속성 조회

# 특정 사용자 조회 Get-MsolUser -UserPrincipalName "silee@kspark004.onmicrosoft.com" # 특정 사용자의 특정 속성 정보 조회 (pipe('|')를 사용하여 두가지 명령을 한 줄에 사용할 수 있습니다)  Get-MsolUser -UserPrincipalName "silee@kspark004.onmicrosoft.com" | Select UserPrincipalName, DisplayName, Title, Department # 특정 사용자의 모든 속성 정보 조회 (sql 조회문과 비슷하여 모든 속성정보가 표시됩니다) Get-MsolUser -UserPrincipalName "silee@kspark004.onmicrosoft.com" | Select *

특정 조건으로 조회 (4개의 명령어 조회 결과는 모두 동일합니다)

# 부서명이 "정보 기술"인 모든 사용자 조회 Get-MsolUser -All -Department "정보 기술" # 부서명이 "정보 기술"인 모든 사용자 조회 (위 명령어와 다른 점은 부서가 '정보 기술'과 같지 않은 건도 조회 가능) Get-MsolUser -All | where {$_.Department -eq "정보 기술"}; # 부서명이 "정보 기술"인 사용자 중에서 라이선스가 발급된 사용자 조회 Get-MsolUser -All -Department "정보 기술" | where {$_.isLicensed -eq $true}; # 변수를 사용하여 부서명이 "정보 기술"인 사용자 중에서 라이선스가 발급된 사용자 조회 $DeptUser = Get-MsolUser -All -Department "정보 기술"; $DeptUser | where {$_.isLicensed -eq $true}; * 참고 : Where-Object {$_.[user account property name] [comparison operator] [value]} comparison operator : -eq (같다), -ne (같지않다), -lt (보다 작다), -gt (보다 크다) 등이 있습니다. value : 보통 문자열(문자, 숫자 또는 기타 문자열)이 사용하지만 숫자값이나 $Null 등 의 값이 사용될 수 있습니다.

사용자 등록

사용자 등록은 New-MsolUser 를 사용합니다. 한 두명의 사용자 등록은 관리포털을 사용하는 것이 더 빠를 수도 있으나, 정형화된 작업이 많은 경우 Powershell을 사용하는 것이 편리할 때도 있습니다. 단 별도 옵션을 지정하지 않으면 사용자의 비밀번호는 시스템에서 자동으로 생성하여 반환하고, 라이선스는 미할당 상태로 사용자가 생성됩니다.

새 사용자 등록 시 추가 속성으로 -Password 를 사용하면 관리자가 특정 비밀번호를 지정할 수 있고 -ForceChangePassword 를 $true로 설정하면 사용자는 관리자가 지정한 비밀번호로 로그인하고 로그인 후 반드시 사용자가 비밀번호로 변경하도록 할 수 있습니다. 또 -LicenseAssignment는 생성과 함께 생성되는 사용자에게 지정하는 라이선스를 부여할 수 있습니다.

라이선스 지정에 사용되는 값은 Powershell 2편을 참조하시거나 2편에 소개된 라이선스 외의 값은 Google 검색을 하시면 쉽게 찾을 수 있습니다.

# 새 사용자 등록 - UserPrincipalName은 필수이며 도메인 값이 현재의 테넌트(kspark004.onmicrosoft.com)나 커스텀 도메인과 일치해야 합니다 New-MsolUser -UserPrincipalName "spark@kspark004.onmicrosoft.com" -FirstName "기석" -LastName "박" -DisplayName "박기석" -Title "과장" -Department "연구소" -Office "1111" -PhoneNumber "02-0000-6186" -MobilePhone "010-0000-9545" -Fax "02-0000-6004" -StreetAddress "강남구 삼성로 29길" -City "서울특별시" -State "" -PostalCode "135-879" -Country "대한민국" # 새 사용자 등록 시 추가 속성 - 지역설정(필수), 라이선스 할당, 비밀번호 설정, 강제 비밀번호 변경 (UsageLocation(라이선스할당을 위한 필수), LicenseAssignment, Password, ForceChangePassword) New-MsolUser -UserPrincipalName "spark2@kspark004.onmicrosoft.com" -FirstName "기석2" -LastName "박" -DisplayName "박기석2" -Title "과장" -Department "연구소" -Office "1111" -PhoneNumber "02-0000-6186" -MobilePhone "010-0000-9545" -Fax "02-0000-6004" -StreetAddress "강남구 삼성로 29길" -City "서울특별시" -State "" -PostalCode "135-879" -Country "대한민국" -UsageLocation "KR" -LicenseAssignment "kspark004:ENTERPRISEPREMIUM" -Password "P@ssW0rd!" -ForceChangePassword $true

이 글에서 다룬 내용은 제가 주로 사용하고 참고할만 하다고 생각했던 것만 갈무리하여 설명하였습니다. 지금까지 기술한 내용 외에 더 많은 사용자 조회 및 등록의 옵션과 예제를 원하시면 아래 참고 사이트에 방문해 보시기 바랍니다. 

※ 참고 사이트

• https://technet.microsoft.com/ko-kr/library/mt614244.aspx
• https://docs.microsoft.com/en-us/powershell/module/msonline/get-msoluser?view=azureadps-1.0
  
• https://msdn.microsoft.com/powershell/reference/5.1/microsoft.powershell.core/Where-Object
• https://msdn.microsoft.com/en-us/powershell/reference/5.1/microsoft.powershell.core/foreach-object
  
• https://technet.microsoft.com/ko-kr/library/mt628067.aspx
  
• https://docs.microsoft.com/en-us/powershell/module/msonline/new-msoluser?view=azureadps-1.0