Nel mondo frenetico ed esigente dell’IT, ogni strumento che fa risparmiare tempo e semplifica le attività vale oro. Oggi esploreremo il modo in cui gli script PowerShell possono essere utilizzati per automatizzare le installazioni di Office 365, un’operazione fondamentale che può far risparmiare innumerevoli ore nel lungo periodo. Infatti, con uno script ben scritto, è possibile gestire le installazioni di un’intera rete dalla propria scrivania. Questo post è rivolto ai professionisti IT e ai Managed Service Provider (MSP) che desiderano semplificare le loro implementazioni di Office 365 utilizzando la potenza di PowerShell.
Perché automatizzare le installazioni di Office 365 con PowerShell?
PowerShell è un linguaggio di scripting avanzato e una shell sviluppata da Microsoft. È parte integrante dell’ecosistema Windows fin da Windows 7 e la sua potenza e flessibilità lo hanno reso uno strumento fondamentale per molti professionisti IT e MSP. Automatizzare le installazioni di Office 365 tramite PowerShell può ridurre drasticamente il tempo e l’impegno necessari per distribuire Office 365 su più macchine.
Inoltre, gli script PowerShell possono essere personalizzati in base alle proprie esigenze. Ad esempio, lo script può essere configurato per installare componenti specifici di Office 365, applicare determinate impostazioni e persino effettuare la pulizia dopo l’installazione. Questo livello di personalizzazione consente ai professionisti IT e agli MSP di garantire che Office 365 venga distribuito in modo coerente su tutti i computer, allineandosi alle policy e agli standard IT dell’azienda.
Un’immersione profonda nello script PowerShell per automatizzare le installazioni di Office 365
Vediamo un esempio di script PowerShell per automatizzare le installazioni di Office 365. Tale script è stato progettato per automatizzare le installazioni di Office 365 utilizzando un file di configurazione personalizzato o uno predefinito. Nel caso in cui l’installazione non vada a buon fine, lo script fornisce un messaggio di errore, rendendo più semplice la risoluzione dei problemi.
Ciò che rende questo script per automatizzare le installazioni di Office particolarmente utile è la capacità di scaricare e utilizzare Office Deployment Tool dai server di Microsoft. Questa funzionalità garantisce che per l’installazione venga sempre utilizzata la versione più recente di Office 365. Inoltre, lo script verifica se la suite Office 365 è stata installata correttamente, fornendo un ulteriore livello di garanzia.
Quando l’installazione è riuscita, lo script attiva il riavvio del sistema. Ciò è particolarmente utile perché alcuni componenti di Office 365 richiedono un riavvio del sistema per funzionare correttamente. Lo script è inoltre dotato di un meccanismo di pulizia che può essere attivato per rimuovere i file di installazione dopo che Office 365 è stato installato.
Script PowerShell per automatizzare le installazioni di Office 365
#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/it/condizioni-utilizzo/
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 {}
Accedi a oltre 700 script nel Dojo di NinjaOne
Scenari esemplificativi dello script per automatizzare le installazioni di Office
Scenario n.1: Distribuzione su larga scala
Supponiamo che tu sia un amministratore IT di un’azienda che sta per assumere un centinaio di nuovi dipendenti. Installare manualmente Office 365 su ogni computer sarebbe un’impresa ardua. È invece possibile utilizzare questo script PowerShell per automatizzare le installazioni di Office. Utilizzando NinjaOne per eseguire lo script da remoto su ogni dispositivo, è possibile automatizzare le installazioni di Office 365 in tutta la rete. Questo approccio semplificato non solo fa risparmiare tempo prezioso, ma garantisce anche l’uniformità, una caratteristica essenziale per gestire efficacemente una grande infrastruttura IT.
Scopri come NinjaOne può migliorare l’efficienza della tua infrastruttura IT.
Link: https://www.ninjaone.com/it/efficienza-it
Scenario 2: Forza lavoro a distanza
Con l’aumento del lavoro a distanza, molte aziende hanno dipendenti che lavorano da varie posizioni con i propri dispositivi. Assicurarsi che ogni lavoratore remoto abbia una versione di Office 365 correttamente installata e configurata può essere una sfida. Distribuire questo script PowerShell per automatizzare le installazioni di Office alla tua forza lavoro remota consentirà a tutti i dipendenti di avere Office 365 senza doversi preoccupare dell’installazione. Lo script assicura che Office 365 sia installato correttamente e configurato in base agli standard dell’organizzazione.
Scenario 3: Gestione dei clienti MSP
Come fornitore di servizi gestiti (MSP) è possibile che tu gestisca l’IT di diverse piccole imprese, ognuna con esigenze e configurazioni specifiche. Con questo script PowerShell è possibile creare più file di configurazione XML su misura per ogni cliente. Quando è il momento di installare o aggiornare Office 365 per un cliente, è sufficiente eseguire lo script con il file di configurazione appropriato. Questo garantisce una configurazione personalizzata e coerente di Office 365 per ciascuno dei tuoi clienti.
Scenario 4: Aggiornamenti regolari
Office 365 viene aggiornato regolarmente da Microsoft e mantenere aggiornate le installazioni della tua organizzazione può essere un compito dispendioso in termini di tempo. Con questo script, è possibile programmare l’esecuzione di aggiornamenti automatici in un momento opportuno, garantendo un’interruzione minima del flusso di lavoro del team. Lo script utilizza Office Deployment Tool per scaricare e installare l’ultima versione di Office 365, assicurando che il team abbia sempre accesso alle ultime funzionalità e agli aggiornamenti di sicurezza.
In ognuno dei scenari, questo script PowerShell può semplificare in modo significativo il processo di installazione e di gestione di Office 365. Automatizzando queste attività, è possibile risparmiare tempo, ridurre il rischio di errori e garantire agli utenti un’esperienza Office 365 coerente e affidabile.
Utilizzo dello script per automatizzare le installazioni di Office 365 nel flusso di lavoro
L’integrazione di questo script PowerShell nel proprio flusso di lavoro può semplificare il processo di distribuzione di Office 365. Invece di scaricare ed eseguire manualmente Office Deployment Tool su ogni computer, lo script può essere eseguito in remoto da una postazione centrale per automatizzare le installazioni di Office. Questo riduce le possibilità di errore umano e garantisce una configurazione standard per tutte le installazioni.
Inoltre, personalizzando il file di configurazione XML, è possibile adattare l’installazione di Office 365 alle esigenze della propria organizzazione. Questo include l’indicazione della versione di Office 365, del canale di aggiornamento e persino dei singoli componenti di Office da installare.
Considerazioni finali
L’automazione è la migliore amica di un professionista IT e PowerShell offre un modo potente per automatizzare le installazioni di Office 365. Questo pratico script non solo semplifica il processo di distribuzione, ma fornisce anche opzioni di personalizzazione e funzionalità di pulizia.
Integrando lo script per automatizzare le installazioni di Office 365 nel tuo flusso di lavoro, potrai ridurre significativamente il tempo e l’impegno necessari per gestire le installazioni di Office 365 nella tua rete. Quindi, sfrutta la potenza di PowerShell e rendi semplici le implementazioni di Office 365.
NinjaOne è in grado di semplificare le operazioni automatizzando le attività ripetitive e che richiedono molto tempo. L’interfaccia intuitiva consente ai tecnici di tutti i livelli di applicare facilmente l’automazione agli endpoint, compresi gli script personalizzati da un’ampia libreria, rendendo la risoluzione facile e intuitiva. Come ha notato Chris Hesler della Crossroads Church, “NinjaOne ci ha aiutato… a ridurre le ore di lavoro… siamo in grado di automatizzare maggiormente la libreria di script per risolvere i nostri problemi ricorrenti”. Scopri il potere rivoluzionario dell’automazione nelle tue operazioni IT con NinjaOne, uno strumento progettato all’insegna della flessibilità e dell’intuitività.
