229a04fcbf
This pr is auto merged as it contains a mandatory file and is opened for more than 10 days. |
||
---|---|---|
.vscode | ||
Docs | ||
Functions | ||
.gitignore | ||
LICENSE.txt | ||
MicrosoftGraphSecurity.psd1 | ||
MicrosoftGraphSecurity.psm1 | ||
README.md | ||
SECURITY.md | ||
doc.md |
README.md
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.
Microsoft Graph Security PowerShell Module [ Unofficial]
Welcome to the Unofficial Microsoft Graph Security PowerShell module!
This module is a collection of easy-to-use cmdlets and functions designed to make it easy to interface with the Microsoft Graph Security API.
Why is it unofficial, you ask? Even though this module was designed by Microsoft employees, it is NOT a formal part of the Graph Security API product and you will not be able to get support through standard Microsoft channels. That said, if you have problems or questions, please open an issue here on this Github repo. The authors will be more than happy to help.
Prerequisites
To get value from this module you must...
...have PowerShell v5+ (comes standard on Windows 10)
...have configured authorization for access by registering an application. See Authorization and the Microsoft Graph Security API
App Registration Settings
Register an application with Azure AD with the following
- Authentication
- Select the Suggested Redirect URI to be
urn:ietf:wg:oauth:2.0:oob
- Select Implicit grant issued by the authorization endpoint
Access Tokens
- Select the Suggested Redirect URI to be
- API Permissions
- Add Microsoft Graph Delegated Permissions
SecurityEvents.Read.Al
l and/orSecurityEvents.ReadWrite.All
- Add Microsoft Graph Delegated Permissions
Getting Started
To get started with the module, open your PowerShell terminal as an administrator and install the module from the PSGallery by running this simple command:
Install-Module MicrosoftGraphSecurity
If this is your first time installing a module, you will get prompted to install the Nuget Package Provider. Nuget is the Package/Module manager used by the PSGallery repository.
Contributing
Apologies, we are not currently opening up this project for contribution outside of our existing team. This may change in the future if there is enough interest.
Authors
- Anisha Gupta - Co-Lead Dev - LinkedIn
- Nicholas DiCola - Co-Lead Dev - LinkedIn
- Mike Kassis - Test Design - LinkedIn
See also the list of contributors who participated in this project.
License
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.