Merge pull request #7 from bmrodrigues/main

Administrative and license work for compliance and simplicity

MDEcli/LICENSE.TXT

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Microsoft Corporation.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE

MDEcli/README.MD

@@ -0,0 +1,43 @@
+# MDE CLI
+This sample code creates an easy way to interact with Microsoft Defedner for Endpoint through a cli. This can be ran from any OS as long it's running python 3.6 or above
+
+# Requirements and Instalation
+MDE CLI  can be ran from any OS as long it's running python 3.6 or above. You'll be required to use pip
+
+## Instalation
+pip install -r requiremnts.txt
+
+# Usage
+ ### python app.py -h --> for help menu
+ ### python app.py <choice> -h --> for sub options menu
+ ### python app.py -h
+  
+  usage: app.py [-h] {actions} ...
+
+MDEcli = A tool manage MDE through CLI
+
+optional arguments:
+  -h, --help  show this help message and exit
+
+Available options:
+  {actions}   Choose one of the main options. MDEcli -<option> -h for more details for each main option.
+    actions   MachineAction resource type
+
+Original project created by Bruno Rodrigues - rodrigues.bruno@microsoft.com
+  
+  ### python app.py actions -h
+  
+  usage: app.py actions [-h] [-offboard] [-quick]
+
+optional arguments:
+  -h, --help  show this help message and exit
+  -offboard   Offboard device from Defender for Endpoint.
+  -quick      Initiate Microsoft Defender Antivirus quick scan on a device.
+  
+## Example
+  ### python app.py actions -offboard
+  This command will allow you to offboard multiple machines at a ytime by using the Device List exported from MDE portal.
+ 
+# Code Distribution
+MAKE SURE YOU ALWAYS SEND LICENSE.TXT WITH THE SAMPLE CODE. This mandatory by Microsfot Policy. 
+More details - https://internal.evergreen.microsoft.com/en-us/topic/ef3296ef-1480-ae0f-1741-7b838d32fd36 (internal use only)

README.md

@@ -1,14 +1,15 @@
+---
+page_type: sample
+languages:
+- python
+products:
+- mdatp API
+description: "Auxiliary tools and sampled for Microsoft Defender ATP Cross-Platform"
+---
+
 # Project
 
-> This repo has been populated by an initial template to help get you started. Please
-> make sure to update the content to build a great experience for community-building.
-
-As the maintainer of this project, please make a few updates:
-
-- Improving this README.MD file to provide a great experience
-- Updating SUPPORT.MD with content about this project's support experience
-- Understanding the security reporting process in SECURITY.MD
-- Remove this section from the README
+Welcome to Python for Security, the repo that cotains multiple examples on how to use python with our greatest security products and features. Be part of this changing community that aims to make organizations more secure by leveraging the power of python with Microsoft Azure Security Solutions.
 
 ## Contributing