In de snelle en veeleisende wereld van IT is elke tool die tijd bespaart en taken vereenvoudigt goud waard. Vandaag gaan we onderzoeken hoe PowerShell scripts kunnen worden gebruikt om de installatie van Office 365 te automatiseren, een cruciale operatie die je op de lange termijn talloze uren kan besparen. Met een goed geschreven script kunt u zelfs installaties over een heel netwerk beheren vanaf uw bureau. Dit bericht is bedoeld voor IT-professionals en Managed Service Providers (MSP’s) die hun Office 365-implementaties willen stroomlijnen met behulp van de kracht van PowerShell.
Waarom automatiseren met PowerShell?
PowerShell is een geavanceerde scripttaal en shell, ontwikkeld door Microsoft. Het is een integraal onderdeel van het Windows ecosysteem sinds Windows 7, en de kracht en flexibiliteit hebben het een essentieel hulpmiddel gemaakt voor veel IT-professionals en MSP’s. Het automatiseren van Office 365-installaties met PowerShell kan de tijd en moeite die nodig zijn om Office 365 op meerdere machines te implementeren drastisch verminderen.
Bovendien kunnen PowerShell-scripts worden aangepast aan uw behoeften. Het script kan bijvoorbeeld worden geconfigureerd om specifieke Office 365 componenten te installeren, bepaalde instellingen toe te passen en zelfs op te ruimen na de installatie. Met dit niveau van maatwerk kunnen IT-professionals en MSP’s ervoor zorgen dat Office 365 consistent wordt geïmplementeerd op alle machines, in overeenstemming met het IT-beleid en de IT-standaarden van het bedrijf.
Dieoer ingaan op PowerShell Office 365-script installeren
Laten we eens kijken naar een voorbeeld PowerShell script voor het automatiseren van Office 365 installaties. Dit script is ontworpen om Office 365 te installeren met behulp van een aangepast configuratiebestand of een standaard configuratiebestand. In het geval dat een installatie mislukt, zal het script een foutmelding geven, waardoor het oplossen van problemen eenvoudiger wordt.
Wat dit script bijzonder nuttig maakt, is de mogelijkheid om de Office Deployment Tool van de servers van Microsoft te downloaden en te gebruiken. Deze functie zorgt ervoor dat altijd de nieuwste versie van Office 365 wordt gebruikt voor de installatie. Bovendien controleert het script of de Office 365-suite correct is geïnstalleerd, wat een extra zekerheid biedt.
Na een succesvolle installatie start het script het systeem opnieuw op. Dit is vooral handig omdat sommige onderdelen van Office 365 een herstart van het systeem vereisen om correct te functioneren. Het script is ook uitgerust met een opschoonmechanisme dat kan worden geactiveerd om installatiebestanden te verwijderen nadat Office 365 is geïnstalleerd.
Microsoft Office 365 Installatie PowerShell Script
#Requires -Version 5.1
<#
.SYNOPSIS
Installs Office 365 from config file or use a generic config file and installs.
.DESCRIPTION
Installs Office 365 from config file or use a generic config file and installs.
.EXAMPLE
No parameters need if you want to use
the default config file
OR
change the $OfficeXML variable to your XML config file's content.
.EXAMPLE
-ConfigurationXMLFile C:ScriptsOffice365InstallConfig.xml
Install Office 365 and use a local config file.
You can use https://config.office.com/ to help build the config file.
.OUTPUTS
None
.NOTES
This will reboot after a successful install.
Minimum OS Architecture Supported: Windows 10, Windows Server 2016
If you use the ConfigurationXMLFile parameter and push the file to the endpoint, you can use https://config.office.com/ to help build the config file.
Release Notes:
Initial Release
(c) 2023 NinjaOne
By using this script, you indicate your acceptance of the following legal terms as well as our Terms of Use at https://www.ninjaone.com/nl/gebruiksvoorwaarden
Ownership Rights: NinjaOne owns and will continue to own all right, title, and interest in and to the script (including the copyright). NinjaOne is giving you a limited license to use the script in accordance with these legal terms.
Use Limitation: You may only use the script for your legitimate personal or internal business purposes, and you may not share the script with another party.
Republication Prohibition: Under no circumstances are you permitted to re-publish the script in any script library or website belonging to or under the control of any other software provider.
Warranty Disclaimer: The script is provided “as is” and “as available”, without warranty of any kind. NinjaOne makes no promise or guarantee that the script will be free from defects or that it will meet your specific needs or expectations.
Assumption of Risk: Your use of the script is at your own risk. You acknowledge that there are certain inherent risks in using the script, and you understand and assume each of those risks.
Waiver and Release: You will not hold NinjaOne responsible for any adverse or unintended consequences resulting from your use of the script, and you waive any legal or equitable rights or remedies you may have against NinjaOne relating to your use of the script.
EULA: If you are a NinjaOne customer, your use of the script is subject to the End User License Agreement applicable to you (EULA).
#>
[CmdletBinding()]
param(
# Use a existing config file
[String]
$ConfigurationXMLFile,
# Path where we will store our install files and our XML file
[String]
$OfficeInstallDownloadPath = 'C:ScriptsOffice365Install',
# Clean up our install files
[Switch]
$CleanUpInstallFiles = $False
)
begin {
function Set-XMLFile {
# XML data that will be used for the download/install
# Example config below generated from https://config.office.com/
# To use your own config, just replace <Configuration> to </Configuration> with your xml config file content.
# Notes:
# "@ can not have any character after it
# @" can not have any spaces or character before it.
$OfficeXML = [XML]@"
<Configuration ID="76b3b530-54a8-44d8-9689-278ec2547592">
<Info Description="Example O365 install" />
<Add OfficeClientEdition="64" Channel="MonthlyEnterprise" MigrateArch="TRUE">
<Product ID="O365BusinessRetail">
<Language ID="MatchOS" />
<Language ID="MatchPreviousMSI" />
<ExcludeApp ID="Access" />
<ExcludeApp ID="Groove" />
<ExcludeApp ID="Lync" />
<ExcludeApp ID="Publisher" />
</Product>
</Add>
<Property Name="SharedComputerLicensing" Value="0" />
<Property Name="FORCEAPPSHUTDOWN" Value="TRUE" />
<Property Name="DeviceBasedLicensing" Value="0" />
<Property Name="SCLCacheOverride" Value="0" />
<Updates Enabled="TRUE" />
<RemoveMSI />
<AppSettings>
<Setup Name="Company" Value="Ninja Example" />
<User Key="softwaremicrosoftoffice16.0exceloptions" Name="defaultformat" Value="51" Type="REG_DWORD" App="excel16" Id="L_SaveExcelfilesas" />
<User Key="softwaremicrosoftoffice16.0powerpointoptions" Name="defaultformat" Value="27" Type="REG_DWORD" App="ppt16" Id="L_SavePowerPointfilesas" />
<User Key="softwaremicrosoftoffice16.0wordoptions" Name="defaultformat" Value="" Type="REG_SZ" App="word16" Id="L_SaveWordfilesas" />
</AppSettings>
<Display Level="None" AcceptEULA="TRUE" />
<Setting Id="SETUP_REBOOT" Value="Never" />
<Setting Id="REBOOT" Value="ReallySuppress"/>
</Configuration>
"@
#Save the XML file
$OfficeXML.Save("$OfficeInstallDownloadPathOfficeInstall.xml")
}
function Get-ODTURL {
[String]$MSWebPage = Invoke-RestMethod 'https://www.microsoft.com/en-us/download/confirmation.aspx?id=49117'
$MSWebPage | ForEach-Object {
if ($_ -match 'url=(https://.*officedeploymenttool.*.exe)') {
$matches[1]
}
}
}
function Test-IsElevated {
$id = [System.Security.Principal.WindowsIdentity]::GetCurrent()
$p = New-Object System.Security.Principal.WindowsPrincipal($id)
if ($p.IsInRole([System.Security.Principal.WindowsBuiltInRole]::Administrator))
{ Write-Output $true }
else
{ Write-Output $false }
}
}
process {
$VerbosePreference = 'Continue'
$ErrorActionPreference = 'Stop'
if (-not (Test-IsElevated)) {
Write-Error -Message "Access Denied. Please run with Administrator privileges."
exit 1
}
$CurrentPrincipal = New-Object Security.Principal.WindowsPrincipal([Security.Principal.WindowsIdentity]::GetCurrent())
if (!($CurrentPrincipal.IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator))) {
Write-Warning 'Script is not running as Administrator'
Write-Warning 'Please rerun this script as Administrator.'
exit 1
}
if (-Not(Test-Path $OfficeInstallDownloadPath )) {
New-Item -Path $OfficeInstallDownloadPath -ItemType Directory | Out-Null
}
if (!($ConfigurationXMLFile)) {
Set-XMLFile
}
else {
if (!(Test-Path $ConfigurationXMLFile)) {
Write-Warning 'The configuration XML file is not a valid file'
Write-Warning 'Please check the path and try again'
exit 1
}
}
$ConfigurationXMLFile = "$OfficeInstallDownloadPathOfficeInstall.xml"
$ODTInstallLink = Get-ODTURL
#Download the Office Deployment Tool
Write-Verbose 'Downloading the Office Deployment Tool...'
try {
Invoke-WebRequest -Uri $ODTInstallLink -OutFile "$OfficeInstallDownloadPathODTSetup.exe"
}
catch {
Write-Warning 'There was an error downloading the Office Deployment Tool.'
Write-Warning 'Please verify the below link is valid:'
Write-Warning $ODTInstallLink
exit 1
}
#Run the Office Deployment Tool setup
try {
Write-Verbose 'Running the Office Deployment Tool...'
Start-Process "$OfficeInstallDownloadPathODTSetup.exe" -ArgumentList "/quiet /extract:$OfficeInstallDownloadPath" -Wait
}
catch {
Write-Warning 'Error running the Office Deployment Tool. The error is below:'
Write-Warning $_
exit 1
}
#Run the O365 install
try {
Write-Verbose 'Downloading and installing Microsoft 365'
$Silent = Start-Process "$OfficeInstallDownloadPathSetup.exe" -ArgumentList "/configure $ConfigurationXMLFile" -Wait -PassThru
}
Catch {
Write-Warning 'Error running the Office install. The error is below:'
Write-Warning $_
}
#Check if Office 365 suite was installed correctly.
$RegLocations = @('HKLM:SOFTWAREMicrosoftWindowsCurrentVersionUninstall',
'HKLM:SOFTWAREWOW6432NodeMicrosoftWindowsCurrentVersionUninstall'
)
$OfficeInstalled = $False
foreach ($Key in (Get-ChildItem $RegLocations) ) {
if ($Key.GetValue('DisplayName') -like '*Microsoft 365*') {
$OfficeVersionInstalled = $Key.GetValue('DisplayName')
$OfficeInstalled = $True
}
}
if ($OfficeInstalled) {
Write-Verbose "$($OfficeVersionInstalled) installed successfully!"
shutdown.exe -r -t 60
}
else {
Write-Warning 'Microsoft 365 was not detected after the install ran'
}
if ($CleanUpInstallFiles) {
Remove-Item -Path $OfficeInstallDownloadPath -Force -Recurse
}
}
end {}
|
#Requires -Version 5.1
<#
.SYNOPSIS
Installs Office 365 from config file or use a generic config file and installs.
.DESCRIPTION
Installs Office 365 from config file or use a generic config file and installs.
.EXAMPLE
No parameters need if you want to use
the default config file
OR
change the $OfficeXML variable to your XML config file's content.
.EXAMPLE
-ConfigurationXMLFile C:ScriptsOffice365InstallConfig.xml
Install Office 365 and use a local config file.
You can use https://config.office.com/ to help build the config file.
.OUTPUTS
None
.NOTES
This will reboot after a successful install.
Minimum OS Architecture Supported: Windows 10, Windows Server 2016
If you use the ConfigurationXMLFile parameter and push the file to the endpoint, you can use https://config.office.com/ to help build the config file.
Release Notes:
Initial Release
By using this script, you indicate your acceptance of the following legal terms as well as our Terms of Use at https://www.ninjaone.com/terms-of-use.
Ownership Rights: NinjaOne owns and will continue to own all right, title, and interest in and to the script (including the copyright). NinjaOne is giving you a limited license to use the script in accordance with these legal terms.
Use Limitation: You may only use the script for your legitimate personal or internal business purposes, and you may not share the script with another party.
Republication Prohibition: Under no circumstances are you permitted to re-publish the script in any script library or website belonging to or under the control of any other software provider.
Warranty Disclaimer: The script is provided “as is” and “as available”, without warranty of any kind. NinjaOne makes no promise or guarantee that the script will be free from defects or that it will meet your specific needs or expectations.
Assumption of Risk: Your use of the script is at your own risk. You acknowledge that there are certain inherent risks in using the script, and you understand and assume each of those risks.
Waiver and Release: You will not hold NinjaOne responsible for any adverse or unintended consequences resulting from your use of the script, and you waive any legal or equitable rights or remedies you may have against NinjaOne relating to your use of the script.
EULA: If you are a NinjaOne customer, your use of the script is subject to the End User License Agreement applicable to you (EULA).
#>
[CmdletBinding()]
param(
# Use a existing config file
[String]
$ConfigurationXMLFile,
# Path where we will store our install files and our XML file
[String]
$OfficeInstallDownloadPath = 'C:ScriptsOffice365Install',
# Clean up our install files
[Switch]
$CleanUpInstallFiles = $False
)
begin {
function Set-XMLFile {
# XML data that will be used for the download/install
# Example config below generated from https://config.office.com/
# To use your own config, just replace <Configuration> to </Configuration> with your xml config file content.
# Notes:
# "@ can not have any character after it
# @" can not have any spaces or character before it.
$OfficeXML = [XML]@"
<Configuration ID="76b3b530-54a8-44d8-9689-278ec2547592">
<Info Description="Example O365 install" />
<Add OfficeClientEdition="64" Channel="MonthlyEnterprise" MigrateArch="TRUE">
<Product ID="O365BusinessRetail">
<Language ID="MatchOS" />
<Language ID="MatchPreviousMSI" />
<ExcludeApp ID="Access" />
<ExcludeApp ID="Groove" />
<ExcludeApp ID="Lync" />
<ExcludeApp ID="Publisher" />
</Product>
</Add>
<Property Name="SharedComputerLicensing" Value="0" />
<Property Name="FORCEAPPSHUTDOWN" Value="TRUE" />
<Property Name="DeviceBasedLicensing" Value="0" />
<Property Name="SCLCacheOverride" Value="0" />
<Updates Enabled="TRUE" />
<RemoveMSI />
<AppSettings>
<Setup Name="Company" Value="Ninja Example" />
<User Key="softwaremicrosoftoffice16.0exceloptions" Name="defaultformat" Value="51" Type="REG_DWORD" App="excel16" Id="L_SaveExcelfilesas" />
<User Key="softwaremicrosoftoffice16.0powerpointoptions" Name="defaultformat" Value="27" Type="REG_DWORD" App="ppt16" Id="L_SavePowerPointfilesas" />
<User Key="softwaremicrosoftoffice16.0wordoptions" Name="defaultformat" Value="" Type="REG_SZ" App="word16" Id="L_SaveWordfilesas" />
</AppSettings>
<Display Level="None" AcceptEULA="TRUE" />
<Setting Id="SETUP_REBOOT" Value="Never" />
<Setting Id="REBOOT" Value="ReallySuppress"/>
</Configuration>
"@
#Save the XML file
$OfficeXML.Save("$OfficeInstallDownloadPathOfficeInstall.xml")
}
function Get-ODTURL {
[String]$MSWebPage = Invoke-RestMethod 'https://www.microsoft.com/en-us/download/confirmation.aspx?id=49117'
$MSWebPage | ForEach-Object {
if ($_ -match 'url=(https://.*officedeploymenttool.*.exe)') {
$matches[1]
}
}
}
function Test-IsElevated {
$id = [System.Security.Principal.WindowsIdentity]::GetCurrent()
$p = New-Object System.Security.Principal.WindowsPrincipal($id)
if ($p.IsInRole([System.Security.Principal.WindowsBuiltInRole]::Administrator))
{ Write-Output $true }
else
{ Write-Output $false }
}
}
process {
$VerbosePreference = 'Continue'
$ErrorActionPreference = 'Stop'
if (-not (Test-IsElevated)) {
Write-Error -Message "Access Denied. Please run with Administrator privileges."
exit 1
}
$CurrentPrincipal = New-Object Security.Principal.WindowsPrincipal([Security.Principal.WindowsIdentity]::GetCurrent())
if (!($CurrentPrincipal.IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator))) {
Write-Warning 'Script is not running as Administrator'
Write-Warning 'Please rerun this script as Administrator.'
exit 1
}
if (-Not(Test-Path $OfficeInstallDownloadPath )) {
New-Item -Path $OfficeInstallDownloadPath -ItemType Directory | Out-Null
}
if (!($ConfigurationXMLFile)) {
Set-XMLFile
}
else {
if (!(Test-Path $ConfigurationXMLFile)) {
Write-Warning 'The configuration XML file is not a valid file'
Write-Warning 'Please check the path and try again'
exit 1
}
}
$ConfigurationXMLFile = "$OfficeInstallDownloadPathOfficeInstall.xml"
$ODTInstallLink = Get-ODTURL
#Download the Office Deployment Tool
Write-Verbose 'Downloading the Office Deployment Tool...'
try {
Invoke-WebRequest -Uri $ODTInstallLink -OutFile "$OfficeInstallDownloadPathODTSetup.exe"
}
catch {
Write-Warning 'There was an error downloading the Office Deployment Tool.'
Write-Warning 'Please verify the below link is valid:'
Write-Warning $ODTInstallLink
exit 1
}
#Run the Office Deployment Tool setup
try {
Write-Verbose 'Running the Office Deployment Tool...'
Start-Process "$OfficeInstallDownloadPathODTSetup.exe" -ArgumentList "/quiet /extract:$OfficeInstallDownloadPath" -Wait
}
catch {
Write-Warning 'Error running the Office Deployment Tool. The error is below:'
Write-Warning $_
exit 1
}
#Run the O365 install
try {
Write-Verbose 'Downloading and installing Microsoft 365'
$Silent = Start-Process "$OfficeInstallDownloadPathSetup.exe" -ArgumentList "/configure $ConfigurationXMLFile" -Wait -PassThru
}
Catch {
Write-Warning 'Error running the Office install. The error is below:'
Write-Warning $_
}
#Check if Office 365 suite was installed correctly.
$RegLocations = @('HKLM:SOFTWAREMicrosoftWindowsCurrentVersionUninstall',
'HKLM:SOFTWAREWOW6432NodeMicrosoftWindowsCurrentVersionUninstall'
)
$OfficeInstalled = $False
foreach ($Key in (Get-ChildItem $RegLocations) ) {
if ($Key.GetValue('DisplayName') -like '*Microsoft 365*') {
$OfficeVersionInstalled = $Key.GetValue('DisplayName')
$OfficeInstalled = $True
}
}
if ($OfficeInstalled) {
Write-Verbose "$($OfficeVersionInstalled) installed successfully!"
shutdown.exe -r -t 60
}
else {
Write-Warning 'Microsoft 365 was not detected after the install ran'
}
if ($CleanUpInstallFiles) {
Remove-Item -Path $OfficeInstallDownloadPath -Force -Recurse
}
}
end {}
Toegang tot meer dan 700 scripts in de NinjaOne Dojo
Scriptvoorbeeldscenario’s
Scenario 1: Grootschalige implementatie
Stel dat u een IT-beheerder bent in een bedrijf dat op het punt staat honderd nieuwe werknemers aan te nemen. Office 365 handmatig installeren op elke computer zou een ontmoedigende taak zijn. In plaats daarvan kunt u dit PowerShell-script gebruiken om het proces te automatiseren. Door NinjaOne te gebruiken om het script op afstand op elk apparaat uit te voeren, kunt u Office 365-installaties in het gehele netwerk standaardiseren. Deze gestroomlijnde aanpak bespaart niet alleen kostbare tijd, maar garandeert ook uniformiteit, een essentiële eigenschap voor het effectief beheren van een grote IT-infrastructuur.
Lees meer over hoe NinjaOne de efficiëntie van uw IT-infrastructuur kan verbeteren.
Link: https://www.ninjaone.com/nl/efficientie/
Scenario 2: Personeel op afstand
Met de opkomst van werken op afstand hebben veel bedrijven werknemers die vanaf verschillende locaties op hun eigen apparaten werken. Het kan een uitdaging zijn om ervoor te zorgen dat elke externe medewerker een correct geïnstalleerde en geconfigureerdeversie van Office 365 heeft. Door dit PowerShell script te verspreiden onder uw externe medewerkers, kunnen ze de installatie zelf uitvoeren. Het script zorgt ervoor dat Office 365 correct wordt geïnstalleerd en geconfigureerd op basis van de standaarden van uw organisatie.
Scenario 3: MSP-klantbeheer
Als Managed Service Provider (MSP) beheert u mogelijk de IT voor verschillende kleine bedrijven, elk met hun eigen specifieke behoeften en configuraties. Met dit PowerShell-script kunt u meerdere XML-configuratiebestanden maken die zijn afgestemd op de behoeften van elke klant. Wanneer het tijd is om Office 365 voor een klant te installeren of bij te werken, voert u gewoon het script uit met het juiste configuratie bestand. Dit zorgt voor een aangepaste en consistente Office 365 setup voor elk van uw klanten.
Scenario 4: Regelmatige updates
Office 365 wordt regelmatig bijgewerkt door Microsoft en hetup-to-datehouden van de installaties van je organisatie op kan een tijdrovende klus zijn. Met dit script kunt u automatische updates plannen om op een geschikt moment uit te voeren, zodat de workflow van uw team zo min mogelijk wordt verstoord. Het script gebruikt de Office Deployment Tool om de nieuwste versie van Office 365 te downloaden en te installeren, zodat uw team altijd toegang heeft tot de nieuwste functies en beveiligingsupdates.
In elk van deze scenario’s kan dit PowerShell script het installatie- en beheerproces van Office 365 aanzienlijk vereenvoudigen. Door deze taken te automatiseren, kunt u tijd besparen, de kans op fouten verkleinen en zorgen voor een consistente en betrouwbare Office 365-ervaring voor uw gebruikers.
Het script gebruiken in uw workflow
Door dit PowerShell-script in uw workflow te integreren, kunt u het implementatieproces van Office 365 vereenvoudigen. In plaats van het handmatig downloaden en uitvoeren van de Office Deployment Tool op elke machine, kan het script op afstand worden uitgevoerd vanaf een centrale locatie. Dit verkleint de kans op menselijke fouten en zorgt voor een standaardconfiguratie in alle installaties.
Bovendien kunt u door het XML-configuratiebestand aan te passen de Office 365-installatie aanpassen aan de behoeften van uw organisatie. Dit omvat het specificeren van de Office 365-versie, het updatekanaal en zelfs de afzonderlijke Office-onderdelen die moeten worden geïnstalleerd.
Slotbeschouwingen:
Automatisering is de beste vriend van een IT-professional en PowerShell biedt een krachtige manier om Office 365-installaties te automatiseren. Dit handige script stroomlijnt niet alleen het implementatieproces, maar biedt ook aanpassingsopties en opruimfunctionaliteit.
Door dit script in uw workflow te integreren, kunt u de tijd en moeite die gemoeid zijn met het beheren van Office 365-installaties in uw netwerk aanzienlijk verminderen. Omarm dus de kracht van PowerShell en maak van Office 365 implementaties een fluitje van een cent.
NinjaOne kunt u activiteiten stroomlijnen door repetitieve en tijdrovende taken te automatiseren. Dankzij de gebruiksvriendelijke interface kunnen technici van alle niveaus eenvoudig automatisering toepassen op endpoints, inclusief aangepaste scripts uit een uitgebreide bibliotheek, waardoor herstel eenvoudig en intuïtief is. Zoals Chris Hesler van Crossroads Church opmerkte: “NinjaOne heeft ons geholpen… de manuren te verminderen… we zijn in staat meer automatisering toe te passen met de scriptbibliotheek om onze terugkerende problemen op te lossen.” Ontdek de transformerende kracht van automatisering in uw IT-activiteiten met NinjaOne, een tool die is ontworpen met flexibiliteit en intuïtiviteit als uitgangspunt.
