| page_type | languages | products | description | ||
|---|---|---|---|---|---|
sample |
|
|
This repository contains PowerShell snippets to demonstrate Microsoft Information Protection (MIP) functionality when interacting with the wider Microsoft cloud platform. |
This repository contains PowerShell snippets to demonstrate Microsoft Information Protection (MIP) functionality when interacting with the wider Microsoft cloud platform.
Checkout the Changelog to see what samples are currently avaialble.
The scripts are licensed "as-is." under the MIT License.
This will depend on the target the scripts are run agains:
- Client: install the current Azure Information Protection unified labeling add-in (https://aka.ms/aipclient) - includes PowerShell cmdlets.
- Cloud: depending on the samples run you will either need the PowerShell cmdlets installed from the Exchange Admin Centre (EAC) or see Connecting to Exchange Online PowerShell (https://docs.microsoft.com/en-us/powershell/exchange/exchange-online/connect-to-exchange-online-powershell/connect-to-exchange-online-powershell?view=exchange-ps)
- An account with permissions to administer the MIP in the M365 Compliance portal
- PowerShell v5.0 on Windows 10 x64 (PowerShell v4.0 is a minimum requirement for the scripts to function correctly)
After the prerequisites are installed or met, perform the following steps to use these scripts:
- Download the contents of the repository to your local Windows machine
- Extract the files to a local folder (e.g. C:\Microsoft-Information-Protection-Samples)
- Run PowerShell x64 from the start menu
- Browse to the directory (e.g. cd C:\Microsoft-Information-Protection-Samples)
- For each Folder in the local repository you can browse to that directory and then run the script of your choice
- Most the scripts require authentication first. Auth examples can be found in the Authentication folder.
- Example Authentication script usage:
- To connect to the Exchange Online PowerShell use the script from C:\Microsoft-Information-Protection-Samples, run "cd .\Authentication"
- Once in the folder run .\Authentictae to EXO.ps1 and select whether this needs to be via Exchange Online Protection (EOP) This sequence of steps can be used for each folder....
Some script samples retrieve information from your O365 tenant, and others may create, delete or update data in these tenants. Understand the impact of each sample script prior to running it; samples should be run using a non-production or "test" tenant.
We're always interested in feedback. If you have any comments to share about the PowerShell samples you can send your questions and suggestions to us in the Issues section of this repository.
Your feedback is important to us. Connect with us on Stack Overflow. Tag your questions with [MicrosoftIP].
- Getting started with sensitive labels
- Microsoft Tech Community MIP Resources
- Admin Guide: Using PowerShell with the Azure Information Protection client
- Administering the Azure Rights Management service by using Windows PowerShell
- Exchange Online PowerShell
- Office 365 Security & Compliance Center PowerShell
- Microsoft Information Protection Blog
- Microsoft Information Protection Forum
Copyright (c) 2020 Microsoft. All rights reserved.
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.