Merge pull request #180 from microsoftgraph/dev

0.5.0 Release

Author: peombwa

CONTRIBUTING.md

@@ -0,0 +1,22 @@
+# Contributing
+
+When contributing to this repository, please first open an an issue describing the update you wish to make, and read over our guidelines.
+
+There are a few different recommended paths to get contributions into the released version of this SDK.
+
+## Filing Issues
+The best way to get started with a contribution is to start a dialog with us. Sometimes features will be under development or out of scope for this SDK and it's best to check before starting work on contribution, especially for large work items.
+
+## Adding Scenario-Based Cmdlets
+- Clone the repo - https://github.com/microsoftgraph/msgraph-sdk-powershell.git.
+- Identify the module(s) that you want add the custom cmdlets to. E.g. [Groups.DirectoryObject](https://github.com/microsoftgraph/msgraph-sdk-powershell/tree/dev/src/Beta/Groups.DirectoryObject/Groups.DirectoryObject).
+- Navigate to the module’s custom folder. E.g. [Groups.DirectoryObject/custom](https://github.com/microsoftgraph/msgraph-sdk-powershell/tree/dev/src/Beta/Groups.DirectoryObject/Groups.DirectoryObject/custom). In here, you will find a readme.md that has basic instructions on how to add custom cmdlets. A full guide can be found [here](https://github.com/Azure/autorest/blob/master/docs/powershell/customization.md#creating-a-new-cmdlet).
+- In the custom directory, add your custom cmdlet naming the file as `{Verb}Mg{Subject}_{Variant}.(cs|ps)`. This file will contain the implementation of your custom cmdlet. You can refer to [NewMgGroupMember_Create.cs](https://github.com/microsoftgraph/msgraph-sdk-powershell/blob/dev/src/Beta/Groups.DirectoryObject/Groups.DirectoryObject/custom/NewMgGroupMember_Create.cs) as an example.
+- Once done, bump up the module version number in the module’s root [readme.md](https://github.com/microsoftgraph/msgraph-sdk-powershell/blob/dev/src/Beta/Groups.DirectoryObject/Groups.DirectoryObject/readme.md#versioning) then run `.\msgraph-sdk-powershell\tools\GenerateModules.ps1 -BetaGraphVersion -RepositoryApiKey *** -Pack -Build` to create, build and export the cmdlets to `..\exports` folder.
+
+## Modifying Existing Cmdlets
+When it comes to modifying existing cmdlets, we recommend you use [AutoREST directive](https://github.com/Azure/autorest.powershell/blob/master/docs/directives.md#cmdlet-hiding-exportation-suppression).
+- Identify cmdlets you want to modify, and the modules they reside in.
+- In the module’s `readme.md`, add your directive in the AutoREST configuration sections to modify the lower-level cmdlets.
+
+ 

config/ModuleMetadata.json

@@ -10,5 +10,5 @@
     "tags": "MicrosoftGraph;Microsoft;Office365;Graph;PowerShell;GraphServiceClient;Outlook;OneDrive;AzureAD;GraphAPI;Productivity;SharePoint;Intune;SDK;",
     "releaseNotes": "See https://aka.ms/GraphPowerShell-Release.",
     "assemblyOriginatorKeyFile": "35MSSharedLib1024.snk",
-    "version": "0.2.1"
+    "version": "0.5.0"
 }

config/ModulesMapping.jsonc

@@ -2,6 +2,7 @@
     "Analytics": "^activitystatistics\\.|^users.userAnalytics$|^users.officeGraphInsights$",
     "Bookings": "^bookingBusinesses\\.|^bookingCurrencies\\.",
     "CloudCommunications": "^communications\\.",
+    "DevicesApps.DeviceAppManagement": "^deviceAppManagement\\.",
     "DevicesApps.MobileAppManagement": "^users.managedAppRegistration$|^users.windowsInformationProtectionDeviceRegistration$",
     "DevicesApps.OfficeConfiguration": "^officeConfiguration\\.",
     "DevicesApps.SharedResources": "^users.mobileAppTroubleshootingEvent$",
@@ -10,6 +11,7 @@
     "Files.Permissions": "^groups.resourceSpecificPermissionGrant$", // Missing in docs
     "Files.Shares": "^shares\\.",
     "Financials": "^financials\\.",
+    "Groups.Actions": "^groups.Actions$",
     "Groups.Calendar": "^groups.calendar$|^groups.event$",
     "Groups.Conversation": "^groups.conversation$",
     "Groups.ConversationThread": "^groups.conversationThread$",
@@ -29,6 +31,7 @@
     "Identity.Application": "^applications\\.|^applicationTemplates\\.",
     "Identity.AppRoleAssignments": "^appRoleAssignments\\.|^users.appRoleAssignment$|^groups.appRoleAssignment$",
     "Identity.AuditLogs": "^auditLogs\\.",
+    "Identity.AuthenticationMethods": "^users.authentication$",
     "Identity.AzureADPIM": "^privilegedRoles\\.|^privilegedRoleAssignments\\.|^privilegedOperationEvents\\.|^privilegedApproval\\.|^privilegedRoleAssignmentRequests\\.",
     "Identity.CertificateBasedAuthConfiguration": "^certificateBasedAuthConfiguration\\.",
     "Identity.ConditionalAccess": "^conditionalAccess\\.",
@@ -64,7 +67,9 @@
     "SchemaExtensions": "^schemaExtensions\\.",
     "Search": "^search\\.|^external\\.|^connections\\.",
     "Security": "^Security\\.",
+    "Sites.Actions": "^sites.Actions$",
     "Sites.Drive": "^sites.drive$",
+    "Sites.Functions": "^sites.Functions$",
     "Sites.List": "^sites.list$",
     "Sites.OneNote": "^sites.onenote$",
     "Sites.Pages": "^sites.sitePage$",
@@ -75,6 +80,7 @@
     "Teams.Chats": "^chats\\.|^users.chat$",
     "Teams.Team": "^teams\\.|^teamsTemplates\\.|^teamwork\\.|^groups.team$",
     "Teams.Teamwork": "^users.userTeamwork$",
+    "Users.Actions": "^users.Actions$",
     "Users.ActivityFeed": "^users.userActivity$",
     "Users.Calendar": "^users.calendar$|^users.calendarGroup$|^users.event$",
     "Users.Contacts": "^users.contact$|^users.contactFolder$",
@@ -96,16 +102,8 @@
     "Users.User": "^users.user$|^users.presence$",
     "Users.UserSettings": "^users.userSettings$",
 
-    // Contains Duplicate Cmdlet
-    // "Sites.Functions": "^sites.Functions$",
-    // "Sites.Actions": "^sites.Actions$",
-
     // Fails to build.
-    // "Users.Actions": "^users.Actions$",
-    // "DevicesApps.DeviceManagement": "^deviceManagement\\.|^users.deviceEnrollmentConfiguration$|^users.deviceManagementTroubleshootingEvent$|^users.managedDevice$|^users.mobileAppIntentAndState$",
-    // "Groups.Actions": "^groups.Actions$",
-    // "DevicesApps.DeviceAppManagement": "^deviceAppManagement\\.",
-    
+    //"DevicesApps.DeviceManagement": "^deviceManagement\\.|^users.deviceEnrollmentConfiguration$|^users.deviceManagementTroubleshootingEvent$|^users.managedDevice$|^users.mobileAppIntentAndState$",
     // "Workbooks": "^workbooks\\.", - Too large
 
     // Invalid / No longer supported