Unofficial PowerShell module for easy interface with the Microsoft Graph Security APIs.
Перейти к файлу
microsoft-github-policy-service[bot] 229a04fcbf
Auto merge mandatory file pr
This pr is auto merged as it contains a mandatory file and is opened for more than 10 days.
2023-06-12 19:00:04 +00:00
.vscode Update 2018-12-07 16:09:07 +00:00
Docs Added Docs 2019-04-01 23:02:47 -07:00
Functions Added Changes based on PSScriptAnalyzer Results 2019-04-02 17:14:08 -07:00
.gitignore Initial commit 2018-11-08 10:59:10 -08:00
LICENSE.txt Updated Module Manifest and License 2019-04-02 17:31:52 -07:00
MicrosoftGraphSecurity.psd1 Updated Module Manifest and License 2019-04-02 17:31:52 -07:00
MicrosoftGraphSecurity.psm1 Added Docs 2019-04-01 23:02:47 -07:00
README.md Update README.md 2019-04-16 15:57:50 -07:00
SECURITY.md Microsoft mandatory file 2023-06-02 18:26:48 +00:00
doc.md new doc 2019-09-05 18:54:58 -07:00

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
  • API Permissions
    • Add Microsoft Graph Delegated Permissions SecurityEvents.Read.All and/or SecurityEvents.ReadWrite.All

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

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.