All posts in PowerShell

Collect Skype for Business Online call data with ease – Powershell

Collect Skype for Business Online call data with ease – Powershell

By Author on Leave a Comment

Collecting Skype for Business Online call data has now got a little bit more easier with Get-SFBOCallData.ps1. This script is designed to leverage the cxdcalldata module created by Jason Slane at Microsoft, for information about the please visit the below link.

https://www.powershellgallery.com/packages/CxdCallData/1.2.4.2

The script

Check if cxdcalldata module exists on the client machine

  • Install module, if it doesnt exist
  • If exist, update with latest version located online

Specify report Start and End date

  • Specify Start Date

Specify report Start and End date

  • Specify Start Date

MFA or Not MFA that is the question

If option 2 is selected, there are less steps

  • Prompt for Skype for Business Online Admin details
  • Report is generated and placed on Desktop

If option 1 is selected, there are a lot more steps due to MFA being enabled.

  • Check Skype for Business Online Connector is installed
    • If not, Connector will be downloaded and installed
  • Prompt for User Principal Name of Skype for Business Online Admin Account
  • Provide your password details

  • Authenticate to MFA
    • This will create the MFA session to Skype for Business Online

  • New-CsOnlineSession will be created and all cmdlets will be imported

  • You will be prompted for your Skype for Business Admin Account again, this is a requirement of the powershell module.

  • Reports will now be generated and placed on your desktop

This concludes the process to require the following reports

  1. All Audio Calls
  2. Client Versions
  3. Federated Communications
  4. Federated Communications Summary
  5. User Devices
  6. User Summary

Download Script

Get-SfBOCallData (0 downloads)

Regards,

The Author – Blogabout.Cloud

Bulk Enable Exchange Online Archiving – PowerShell Script

Bulk Enable Exchange Online Archiving – PowerShell Script

By Author on Leave a Comment

This script enables the Online Archiving Mailbox for users in Exchange Online. The script will generate the log and error outputs by checking if the users exists in Exchange Online based on the information provided in the csv file.

The script needs to be run from the On-prem Exchange environment.

Example of script block, this demonstrates the actions taken within the script to check the csv file row by row and output if sucessful or not.

Foreach ($row in $csv)
{
if (get-remotemailbox -identity $row.mailboxemail)
{
get-remotemailbox -identity $row.mailboxemail | enable-remotemailbox -archive
Add-Content -Path $logfilepath -Value ('{0} SUCCESS: Mailbox {1} enabled for Archive' -f (Get-Date), $row.mailboxemail)
}
else {
$outputfiles |%{ Add-Content -Path $_ -Value ('{0} ERROR: Mailbox {1} not enabled for Archive {2}' -f (Get-Date), $row.mailboxemail, $_.exception.message)}
}
}

Example of csv file used; please note the heading mailboxemail is very important as the script checks for this heading.

To view if an Online archive has been activated in the Mailbox, run the following cmdlets.

It is very easy to enable Online Archiving and verify afterwards if it has been enabled.

Download this script

Enable-RemoteMailbox -Archive (39 downloads)

Regards

Author – Blogabout.Cloud

Populate your Exchange Mailbox with dummy data before migrating to Exchange Online or Vice Versa

Populate your Exchange Mailbox with dummy data before migrating to Exchange Online or Vice Versa

By Author on Leave a Comment

Have you ever had a requirement where you need to populate an Exchange or Office 365 Mailbox with data? This is general a common ask when looking to migrate to/from Exchange Online and can be time consuming if your manually sending emails. The following script has been modified to provide an easy way of sending data using the Send-MailMessage PowerShell cmdlet and also capture better error logging.

I would like to thank Andreas Hähnel for his efforts in creating the original script.

This modified script using Try and Catch variables to ensure the specified File location contains documents which can be used and also provide Help on each parameter. Add-MailboxData.zip (113 downloads)

Add-MailboxData.zip (113 downloads)

Check out the video demonstration below

Detect, Remove, Destroy and Upgrade your Microsoft Teams Module`

Detect, Remove, Destroy and Upgrade your Microsoft Teams Module`

By Author on Leave a Comment

The following script has been designed to detected, remove and upgrade your Microsoft Team PowerShell Module.

How does it work?

The script will initial check if you are running a PowerShell window with evaluated privileges as this is a prerequisites to running this script. Once Administrative privileges have been detected it will compare the installed version of the Microsoft Teams module against the online version located the PSGallery. If the online is greater than the installed version, the script will use the uninstall-module cmdlet to remove the previous version and install the latest version from the PSGallery.

If your installed version matches the online version no actions will be taken.

This script also includes an output of the installed client version of Microsoft Teams with its Ring and Environment information as shown below

Download this script today

Detect-MicrosoftTeams-Version (476 downloads)

Regards

The Author – Blogabout.Cloud

Install PowerShell for Azure Stack

Install PowerShell for Azure Stack

By Author on Leave a Comment

Installing PowerShell for Azure Stack has a number of prerequistes which need to be met. The following script has been designed and tested to preform all the necessary tasks within a single script execution.

The following steps have been taken from https://docs.microsoft.com/en-us/azure/azure-stack/azure-stack-powershell-install

1. Verify your prerequisites

Before your get started with Azure Stack and PowerShell, you will need to have a few requirements in place.

PowerShell Version 5.0
To check your version, run $PSVersionTable.PSVersion and compare the Major version. If you do not have PowerShell 5.0, follow the link to upgrade to PowerShell 5.0.

Note

PowerShell 5.0 requires a Windows machine.

Run Powershell an elevated prompt
You will need to be able to run PowerShell with administrative privileges.

PowerShell Gallery access
You will need access to the PowerShell Gallery. The gallery is the central repository for PowerShell content. The PowerShellGet module contains cmdlets for discovering, installing, updating, and publishing PowerShell artifacts such as modules, DSC resources, role capabilities, and scripts from the PowerShell Gallery and other private repositories. If you are using PowerShell in a disconnected scenario, you will need to retrieve resources from a machine with a connection to the Internet and store them in a location accessible to your disconnected machine.

2. Validate if the PowerShell Gallery is accessible

Validate if PSGallery is registered as a repository.

Note

This step requires Internet access.

Open an elevated PowerShell prompt, and run the following cmdlets:
PowerShell

Import-Module -Name PowerShellGet -ErrorAction Stop
Import-Module -Name PackageManagement -ErrorAction Stop
Get-PSRepository -Name “PSGallery”

If the repository is not registered, open an elevated PowerShell session and run the following command:
PowerShell

Register-PsRepository -Default
Set-PSRepository -Name “PSGallery” -InstallationPolicy Trusted

3. Uninstall existing versions of the Azure Stack PowerShell modules

Before installing the required version, make sure that you uninstall any previously installed Azure Stack AzureRM PowerShell modules. You can uninstall them by using one of the following two methods:

To uninstall the existing AzureRM PowerShell modules, close all the active PowerShell sessions, and run the following cmdlets:
PowerShell

Uninstall-Module AzureRM.AzureStackAdmin -Force
Uninstall-Module AzureRM.AzureStackStorage -Force
Uninstall-Module -Name AzureStack -Force

Delete all the folders that start with Azure from the C:\Program Files\WindowsPowerShell\Modules and C:\Users\AzureStackAdmin\Documents\WindowsPowerShell\Modules folders. Deleting these folders removes any existing PowerShell modules.

4. Connected: Install PowerShell for Azure Stack with Internet connectivity

Azure Stack requires the 2017-03-09-profile API version profile, which is available by installing the AzureRM.Bootstrapper module. In addition to the AzureRM modules, you should also install the Azure Stack-specific PowerShell modules.

Run the following PowerShell script to install these modules on your development workstation:

Version 1.4.0 (Azure Stack 1804 or greater)
PowerShell

# Install the AzureRM.Bootstrapper module. Select Yes when prompted to install NuGet
Install-Module -Name AzureRm.BootStrapper

# Install and import the API Version Profile required by Azure Stack into the current PowerShell session.
Use-AzureRmProfile -Profile 2017-03-09-profile -Force

# Install Module Version 1.4.0 if Azure Stack is running 1804 at a minimum
Install-Module -Name AzureStack -RequiredVersion 1.4.0

Version 1.2.11 (before 1804)
PowerShell

# Install the AzureRM.Bootstrapper module. Select Yes when prompted to install NuGet
Install-Module -Name AzureRm.BootStrapper

# Install and import the API Version Profile required by Azure Stack into the current PowerShell session.
Use-AzureRmProfile -Profile 2017-03-09-profile -Force

# Install Module Version 1.2.11 if Azure Stack is running a lower version than 1804
Install-Module -Name AzureStack -RequiredVersion 1.2.11

Confirm the installation by running the following command:
PowerShell

Get-Module -ListAvailable | where-Object {$_.Name -like “Azs*”}

If the installation is successful, the AzureRM and AzureStack modules are displayed in the output.

All seems simple, right?

PowerShell script demonstration

The following video demonstrates the Set-AzureStackPS script, which is available to download via the following URL.

PowerShell for Azure Stack (102 downloads)

Regards

The Author – Blogabout.Cloud

Granting permissions to users based on Group Membership with PowerShell

Granting permissions to users based on Group Membership with PowerShell

By Author on Leave a Comment

Hello,

Question: Have you ever had to perform a task for multiple users like granting a permission, policy or something else? and did you do it manually?

I can honestly say I have and it was so time consuming, especially when we have free tools available to use to perform theses actions within seconds/minutes instead of hours/days.

I have generated a script below which I have created to grant a Skype for Business Online policy to a number of users based on their Group Membership. Before you run this script the following assumputions will be made.

  • You have a basic understanding of PowerShell Scripting
  • You have modified all locations shown with ‘#########’ to your requirements

For the below script I have left in ‘IMOnly’ to show exactly what this script is designed to achieve. If a User doesnt have the IMOnly policy they will be granted the policy but if a User already has IMOnly granted. The script will skip the user and generate an output on screen plus to a definited .txt file before moving onto the next user.



clear-host

# Define Service Account

$username = '#########'

$password = '#########'

$pass = Convertto-Securestring -String $password -asPlaintext -Force

$credential = New-Object -TypeName System.Management.Automation.PScredential -ArgumentList ($username, $pass)



# Connect to Office 365

Import-Module MSOnline

Connect-MsolService -Credential $credential



# Connect to Skype for Business Online

Import-Module -Name SkypeOnlineConnector

$sfboSession = New-CsOnlineSession -Credential $credential

Import-PSSession -Session $sfboSession -AllowClobber



# Get Group Members

Get-MsolGroupMember -GroupObjectId '#########' | export-csv -Path $env:HOMEDRIVE\INSTALL\#########.csv



# Import Users

$csv = Import-Csv -Path $env:HOMEDRIVE\#########\#########.csv



# Assign CsClientPolicy

Foreach ($row in $csv) {

If(Get-CsOnlineUser -Identity $row.EmailAddress | Where-object {$_.ClientPolicy -notcontains 'IMOnly'})

{

Grant-CsClientPolicy -Identity $row.EmailAddress -PolicyName 'IMOnly'

}

else

{

Write-Host -ForegroundColor Yellow $row.EmailAddress "Skipped User"

get-csonlineuser -id $row.EmailAddress | Where-object {$_.ClientPolicy -contains 'IMOnly'} | select-object DisplayName,ClientPolicy | out-file -FilePath $env:HOMEDRIVE\INSTALL\groupuserenbled.txt

}

}

You can also complete this command for On-Premises users by modifying the script to use Get-ADGroupMember as shown below.



# Get Group Members

Get-ADGroupMember -Identity '#########' | export-csv -Path $env:HOMEDRIVE\INSTALL\#########.csv

This script can be modified to complete other provisioning based on Group Membership, just copy and paste into PowerShell ISE and make the necessary changes

Regards

The Author

Working with PowerShell Global Variables

Working with PowerShell Global Variables

By Author on Leave a Comment

Hello,

I have been recently working on a number of PowerShell scripts which have several different “Functions” and found that I need to use variables that may have been previous set in a previous Function action. If a variable has been set in a function we are not able to just use the $Variable name in the following function so, as we don’t want to be prompting for the same information over and over again we can get around this issue by using Global Variables.

Example script without a global variable.

The following script shows that $accountname prompt has been specified in both functions increase the manual input require to action this script. This is an acceptable method if you wanted to be prompted but in a scripting scenario PowerShell can do a lot more to reduce the need for manual input.



Function Get-Mailbox {

$accountname = Read-Host -Prompt 'Please enter - Account Name'

Get-Mailbox -Name $AccountName

}



Function Set-Mailbox{ 

$accountname = Read-Host -Prompt 'Please enter - Account Name'

$password = Read-Host -Prompt 'Please enter - Password'

Set-Mailbox -Name $accountname -Password $password

}

Example script a global variable.

The following script is now using $Global:AccounName which sits outside of the Function blocks and looks at the $accountname variable when it has been specified or called into action. So any other functions within the script which require the $accountname variable will now be defined as $Global:AccountName as shown below.



$Global:AccountName = $accountname



Function Get-Mailbox {

$accountname = Read-Host -Prompt 'Please enter - Account Name'

Get-Mailbox -Name $AccountName

}



Function Set-Mailbox {

$password = Read-Host -Prompt 'Please enter - Password'

Set-Mailbox -Name $Global:AccountName -Password $password

}

This concludes how to use a Global Variable within your PowerShell script.

Remember: PowerShell is one of the most powerful tools available to all IT Professional and the best of it…. It’s FREE. It only requires you to launch the PowerShell Consoles whether that maybe PowerShell or PowerShell ISE. Start your PowerShell journey today and script actions you complete on a day to day basis to reduce the time and effort required.

Regards

The Author – Blogabout.Cloud