FastTrack/scripts/Get-AuditGuestTeams

Microsoft FastTrack Open Source - Get-AuditGuestTeams

This Script function will create a report that will help IT PROs to Monitor and Audit Guest users. The report generated by the script will show the following details:

1. How many Microsoft 365 Groups contains Guest accounts added as member and to list those Guest accounts and corresponding Group;
2. Sign-in logs in Azure Active Directory - Audits if the Guest accounts already Sign-in in the tenant, if the Guest user accepted the invite and also the last time they Signd-In in the tenant;
3. List what is the current Azure B2B Collaboration restrictions configured;

Once you run the script, you will get a report in the Shell/Screen or you can choose to be exported to a TXT/CSV file; Both ways of executing the script: Getting data on Screen: ".\Get-AuditGuestTeams -ExportMethod onScreen" Getting data on a TXT file and CSV: ".\Get-AuditGuestTeams -ExportMethod Report"

Important Detail: The script will require AzureADPreview module. The script will remove the old modules and install the new and needed modules for you;

Usage

.Requirements

• This Script function needs AzureADPreview module version "2.0.2.138" or higher installed - the script will install/update it for you;
• If you have AzureAD Module installed, this module must be uninstalled first - the script will uninstall it for you;
• Administrator rights to Install/Uninstall Modules;
• Administrator rights in the tenant to list Microsoft 365 Groups/Users and Azure Sign-In logs;
• You must set ExecutionPolicy to allow running the script. Example: Set-ExecutionPolicy -ExecutionPolicy Unrestricted

.PARAMETER: "ExportMethod"

• This parameter will define the way the outcome will be displayed: On Shell/Screen or saved into the Downloads folder of the user profile;

.EXAMPLE:

• ".\Get-AuditGuestTeams -ExportMethod onScreen"
• ".\Get-AuditGuestTeams -ExportMethod Report"

.TOOL:

Applies To

• Microsoft Teams
• Azure

Author

Author	Original Publish Date
Tiago Roxo	22/09/2021

Issues

Please report any issues you find to the issues list.

DO NOT DELETE/ALTER THE SECTIONS BELOW

Support Statement

The scripts, samples, and tools made available through the FastTrack Open Source initiative are provided as-is. These resources are developed in partnership with the community and do not represent official Microsoft software. As such, support is not available through premier or other Microsoft support channels. If you find an issue or have questions please reach out through the issues list and we'll do our best to assist, however there is no associated SLA.

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Legal Notices

Microsoft and any contributors grant you a license to the Microsoft documentation and other content in this repository under the MIT License, see the LICENSE file, and grant you a license to any code in the repository under the MIT License, see the LICENSE-CODE file.

Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.

Privacy information can be found at https://privacy.microsoft.com/en-us/

Microsoft and any contributors reserve all others rights, whether under their respective copyrights, patents, or trademarks, whether by implication, estoppel or otherwise.