{"id":14566,"date":"2023-07-06T08:00:29","date_gmt":"2023-07-06T15:00:29","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/?p=14566"},"modified":"2023-07-06T09:38:59","modified_gmt":"2023-07-06T16:38:59","slug":"microsoft-graph-powershell-v1-to-v2-migration-toolkit","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/microsoft-graph-powershell-v1-to-v2-migration-toolkit\/","title":{"rendered":"Microsoft Graph PowerShell v1 to v2 migration toolkit"},"content":{"rendered":"

Microsoft Graph PowerShell v2 introduces changes that will require v1 users to change their scripts to address issues like naming conventions of command names if their scripts include directives for switching to beta profile.<\/p>\n

To aid users in updating from Microsoft Graph PowerShell v1 to v2 we have a Migration Toolkit<\/a> that identifies and resolves breaking changes.<\/p>\n

The Migration Toolkit has various capabilities depending on the arguments provided. For all the scenarios, the output from the toolkit will give you suggestions on where to change your script. The \u201cLocation\u201d column shows the script name and the line number while the \u201cOriginal\u201d and \u201cAfter\u201d columns show the current commands and the new suggested commands respectively.<\/p>\n

Examples<\/h2>\n

Scenario 1: Identify changes on your script that has both profiles (v1 & Beta profiles)<\/strong><\/p>\n

New-MgMigrationPlan -FilePath \u201c<Location to your script>\u201d<\/code><\/p>\n

In the example below all commands under \u201cSelect-MgProfile -Name \u2018beta\u2019\u201d will have commands updated with the Beta prefix.<\/em><\/p>\n

\"A<\/strong><\/p>\n

Scenario 2: Identify changes on a script to utilize one endpoint (either beta or V1) using -GraphProfile <\/strong><\/p>\n

New-MgMigrationPlan -FilePath \u201c<Location to your script>\u201d -GraphProfile Beta<\/code><\/p>\n

This will subject the whole script to the naming convention of commands as per expectations with PowerShell v2 <\/em><\/p>\n

\"A<\/strong><\/p>\n

Scenario 3: Identify changes on a script and generate a new v2 compliant script. <\/strong><\/p>\n

New-MgMigrationPlan -FilePath \u201c<Location to your script>\u201d -UpdatedFilePath \u201cPath to new generated script\u201d<\/code><\/p>\n

In this scenario, the toolkit provides the user an option of generating a new script with the new suggested changes to the provided path.<\/em><\/p>\n

\"A<\/strong><\/p>\n

\"Graphical<\/strong><\/p>\n

Scenario 4: Identify changes on a script(s) in a directory and generate a new v2 compliant script (s) in a new directory. <\/strong><\/p>\n

New-MgMigrationPlan -Directory \u201c<Directory to your script>\u201d -UpdatedFilePath \u201cPath to new generated script\u201d<\/code><\/p>\n

In this scenario, the toolkit provides the user an option of generating a new scripts for a directory with the new suggested changes to the provided path. Files will be appended with a \u2018Migration-\u2018 prefix on the script names.<\/em><\/p>\n

\"A<\/p>\n

\"A<\/strong><\/p>\n

Next steps<\/h2>\n

Check out this documentation<\/a> for details on breaking changes, fixes and guidance through the migration that an SDK user might run while upgrading to v2 as well as provide examples for implementing the new features, helping you quickly take advantage of all the new capabilities.<\/p>\n

Add the new SDK for Microsoft Graph v1.0 module to your project. You can have a side-by-side installation by running the following command in the Package Manager Console or replace the Microsoft Graph PowerShell SDK installed by removing -AllowClobber<\/code>:<\/p>\n

Install-Module Microsoft.Graph -AllowClobber -Force<\/code><\/p>\n

Or for Microsoft Graph beta module:<\/p>\n

Install-Module Microsoft.Graph.Beta -AllowClobber -Force<\/code><\/p>\n

Follow us on Twitter\u00a0@Microsoft365Dev<\/a>\u00a0for the latest announcements and resources.<\/p>\n

Happy coding!<\/p>\n","protected":false},"excerpt":{"rendered":"

Microsoft Graph PowerShell v2 introduces changes that will require v1 users to change their scripts to address issues like naming conventions of command names if their scripts include directives for switching to beta profile.<\/p>\n","protected":false},"author":117208,"featured_media":14578,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[3],"tags":[149],"class_list":["post-14566","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-graph","tag-microsoft-graph-powershell-sdk"],"acf":[],"blog_post_summary":"

Microsoft Graph PowerShell v2 introduces changes that will require v1 users to change their scripts to address issues like naming conventions of command names if their scripts include directives for switching to beta profile.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/14566","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/117208"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=14566"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/14566\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/14578"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=14566"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=14566"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=14566"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}