Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Digressive/Automate-Office-365-Licensing
PowerShell script to assign Office 365 license to users in an Active Directory OU structure.
https://github.com/Digressive/Automate-Office-365-Licensing
automation licensing office-365 office365 powershell-script
Last synced: 3 months ago
JSON representation
PowerShell script to assign Office 365 license to users in an Active Directory OU structure.
- Host: GitHub
- URL: https://github.com/Digressive/Automate-Office-365-Licensing
- Owner: Digressive
- License: mit
- Created: 2018-11-04T10:26:44.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-05-14T20:46:35.000Z (6 months ago)
- Last Synced: 2024-05-28T02:23:34.022Z (6 months ago)
- Topics: automation, licensing, office-365, office365, powershell-script
- Language: PowerShell
- Size: 29.3 KB
- Stars: 6
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - Digressive/Automate-Office-365-Licensing - PowerShell script to assign Office 365 license to users in an Active Directory OU structure. (PowerShell)
README
# Automate Office 365 Licensing
## Update 2019-06-16
I recently learned that Office 365 licensing can be managed via Azure Active Directory's group based licensing feature and I have since switched to using this and have retired this script. I'll leave this post and the script itself available here, on the Microsoft TechNet Gallery and GitHub, but I'll not be developing the script any further. For more information on Azure Active Directory group-based licensing please check out Microsoft's documentation [here](https://docs.microsoft.com/en-us/azure/active-directory/fundamentals/active-directory-licensing-whatis-azure-portal) and [here](https://docs.microsoft.com/en-us/azure/active-directory/users-groups-roles/licensing-groups-migrate-users) to start with.
PowerShell script to assign Office 365 license to users in an Active Directory OU structure.
For full instructions and documentation, [visit my blog post](https://gal.vin/posts/automated-office-365-licensing/)
Please consider donating to support my work:
* You can support me with a one-time payment [using PayPal](https://www.paypal.me/digressive)
My Automate Office 365 Licensing Utility PowerShell script can also be downloaded from:
* [The Microsoft TechNet Gallery](https://gallery.technet.microsoft.com/Automated-Office-365-8789a236)
Please report any problems via the ‘issues’ tab on GitHub.
-Mike
## Features and Requirements
This utility will assign a configurable Office 365 license to Active Directory user accounts within an OU or descending OUs. All options are added via command line switches. Options include:
* The Office 365 Global Admin user and password to use.
* The Office 365 license and usage location to assign.
* Organisation Unit which contains to users to license.
* The directory to output a log file to.
* An optional email address to send the log file to.
* This utility requires the MSOnline and Active Directory PowerShell modules to be installed.
* The utility requires at least PowerShell 5.0.
* This utility has been tested running on Windows Server 2016.
## Generating A Password File For SMTP Authentication
The password used for SMTP server authentication must be in an encrypted text file. To generate the password file, run the following command in PowerShell, on the computer that is going to run the script and logged in with the user that will be running the script. When you run the command you will be prompted for a username and password. Enter the username and password you want to use to authenticate to your SMTP server.
Please note: This is only required if you need to authenticate to the SMTP server when send the log via e-mail.
``` powershell
$creds = Get-Credential
$creds.Password | ConvertFrom-SecureString | Set-Content c:\scripts\ps-script-pwd.txt
```
After running the commands, you will have a text file containing the encrypted password. When configuring the -Pwd switch enter the path and file name of this file.
## Configuration
Here’s a list of all the command line switches and example configurations.
``` txt
-User365
```
The Office 365 Admin user to use for the operation.
``` txt
-Pwd365
```
The password for the Office 365 Admin user to use for the operation.
``` txt
-Lic
```
The Office 365 license to apply to your users.
``` txt
-UseLoc
```
The Office 365 usage location to use.
``` txt
-OU
```
The top level OU that contains the users to license in Office 365.
``` txt
-L
```
The path to output the log file to. The file name will be Office-365-Licensing.log
``` txt
-Subject
```
The email subject that the email should have. Encapsulate with single or double quotes.
``` txt
-SendTo
```
The e-mail address the log should be sent to.
``` txt
-From
```
The e-mail address the log should be sent from.
``` txt
-Smtp
```
The DNS name or IP address of the SMTP server.
``` txt
-User
```
The user account to connect to the SMTP server.
``` txt
-Pwd
```
The txt file containing the encrypted password for the user account.
``` txt
-UseSsl
```
Configures the script to connect to the SMTP server using SSL.
## Example
``` txt
Office-365-Licensing.ps1 -User365 [email protected] -Pwd365 P@ssw0rd -Lic contosocom:ENTERPRISEPACK -UseLoc GB -OU OU=MyUsers,DC=contoso,DC=com
-L C:\scripts\logs -Subject 'Server: O365 Licensing' -SendTo [email protected] -From [email protected] -Smtp smtp.outlook.com -User user -Pwd c:\scripts\ps-script-pwd.txt -UseSsl
```
This will login to Office 365 with the specified user and assign licenses to the users in the MyUsers OU, and OUs below that. On completion it will e-mail the log file to the specified address with a custom subject line.