1.0.1

Installation instructions

Install the module from the PowerShell gallery

Install-Module -Name Microsoft.Entra -RequiredVersion 1.0.1 -Repository PSGallery -Force -AllowClobber

For beta module

Install-Module -Name Microsoft.Entra.Beta -RequiredVersion 1.0.1 -Repository PSGallery -Force -AllowClobber

Full Changelog: 1.0.0...1.0.1

1.0.0

Release Notes

1.0.0 - January 28, 2025

• New Commands:

  • Update-EntraOauth2PermissionGrant
  • Get-EntraBetaUserAuthenticationMethod
  • Get-EntraUserAuthenticationMethod
  • Update-EntraBetaUserAuthenticationRequirement
  • Get-EntraBetaUserAuthenticationRequirement

• Bug Fixes:

  • RequiredResourceAccess cannot be an array. PR #1229

• Documentation enhancements:

  • Improved examples for over 250 cmdlets.
  • Adding syntax sections for Global Secure Access commands.
  • Enhanced directory sync features and configurations.
  • Fixed example for New-EntraBetaPrivateAccessApplicationSegment.

• Enhancements:

  • Get-EntraContext - Add Entra PowerShell version to response.
  • Update .Net version in the release pipeline.

Installation instructions

Install the module from the PowerShell gallery

Install-Module -Name Microsoft.Entra -RequiredVersion 1.0.0 -Repository PSGallery -Force -AllowClobber

For beta module

Install-Module -Name Microsoft.Entra.Beta -RequiredVersion 1.0.0 -Repository PSGallery -Force -AllowClobber

What's Changed

• Bug Fix: Update-EntraOauth2PermissionGrant by @SteveMutungi254 in #1182
• 0.20.0 release - Enrich examples to boost example quality KPI - Batch 1 by @SteveMutungi254 in #1184
• Bug fix 1185 - Get-EntraBetaServicePrincipalOwner not returning results by @SteveMutungi254 in #1188
• Global secure access commands - Adding syntax sections by @SteveMutungi254 in #1190
• Get-EntraBetaUserAuthenticationMethod by @SteveMutungi254 in #1203
• Get-EntraUserAuthenticationMethod by @SteveMutungi254 in #1202
• Update-EntraBetaUserAuthenticationRequirement - update perUser mfaState by @SteveMutungi254 in #1198
• Get-EntraBetaUserAuthenticationRequirement - perUser mfaState query by @SteveMutungi254 in #1197
• Fix typo in common-functions.ps1 by @SamErde in #1206
• Minor config changes in 1ES release pipeline by @KenitoInc in #1213
• Hotfix - Default format improvements - Get-EntraBetaUserAuthenticationMethod by @SteveMutungi254 in #1215
• Fix RequiredResourceAccess cannot be an array issue in Set-AzureADMSApplication by @PenguinCats in #1229
• Remediate GUIDs per the security dashboard hits by @msewaweru in #1248
• Delete Retired .openpublishing.build.ps1 script of default branch by @shujingMS in #1244
• Enhancement: Get-EntraContext - Add Entra PowerShell version to response by @SteveMutungi254 in #1246
• Hotfix - Update-EntraBetaUserAuthenticationRequirement by @SteveMutungi254 in #1251
• 0.20.0 release - Enrich examples to boost example quality KPI - Batch 7 by @SteveMutungi254 in #1219
• 0.20.0 release - Enrich examples to boost example quality KPI - Batch 6 by @SteveMutungi254 in #1217
• 0.20.0 release - Enrich examples to boost example quality KPI - Batch 5 [domains] by @SteveMutungi254 in #1216
• 0.20.0 release - Enrich examples to boost example quality KPI - Batch 3 [devices] by @SteveMutungi254 in #1196
• 0.20.0 release - Enrich examples to boost example quality KPI - Batch 2 by @SteveMutungi254 in #1193
• 0.20.0 release - Enrich examples to boost example quality KPI - Batch 2 (users) by @SteveMutungi254 in #1189
• Update New-EntraBetaPrivateAccessApplicationSegment.md by @andres-canello in #1275
• Update .Net version| by @KenitoInc in #1298

New Contributors

• @PenguinCats made their first contribution in #1229
• @shujingMS made their first contribution in #1244

Full Changelog: 0.22.0...1.0.0

0.22.0

Installation instructions

Install the module from the PowerShell gallery

Install-Module -Name Microsoft.Entra -RequiredVersion 0.22.0 -Repository PSGallery –Force

For beta module

Install-Module -Name Microsoft.Entra.Beta -RequiredVersion 0.22.0 -Repository PSGallery –Force

Full Changelog: 0.21.0-preview...0.22.0

0.21.0-preview

Installation instructions

Install the module from the PowerShell gallery

Install-Module -Name Microsoft.Entra -RequiredVersion 0.21.0-preview -AllowPrerelease -Repository PSGallery –Force

For beta module

Install-Module -Name Microsoft.Entra.Beta -RequiredVersion 0.21.0-preview -AllowPrerelease -Repository PSGallery –Force

Full Changelog: 0.20.0-preview...0.21.0-preview

0.20.0-preview

Installation instructions

Install the module from the PowerShell gallery

Install-Module -Name Microsoft.Entra -RequiredVersion 0.20.0-preview -AllowPrerelease -Repository PSGallery –Force

For beta module

Install-Module -Name Microsoft.Entra.Beta -RequiredVersion 0.20.0-preview -AllowPrerelease -Repository PSGallery –Force

What's Changed

• Bug Fix: Update-EntraOauth2PermissionGrant by @SteveMutungi254 in #1182
• 0.20.0 release - Enrich examples to boost example quality KPI - Batch 1 by @SteveMutungi254 in #1184
• Bug fix 1185 - Get-EntraBetaServicePrincipalOwner not returning results by @SteveMutungi254 in #1188
• Global secure access commands - Adding syntax sections by @SteveMutungi254 in #1190
• Get-EntraBetaUserAuthenticationMethod by @SteveMutungi254 in #1203
• Get-EntraUserAuthenticationMethod by @SteveMutungi254 in #1202
• Update-EntraBetaUserAuthenticationRequirement - update perUser mfaState by @SteveMutungi254 in #1198
• Get-EntraBetaUserAuthenticationRequirement - perUser mfaState query by @SteveMutungi254 in #1197
• Fix typo in common-functions.ps1 by @SamErde in #1206
• Minor config changes in 1ES release pipeline by @KenitoInc in #1213
• Hotfix - Default format improvements - Get-EntraBetaUserAuthenticationMethod by @SteveMutungi254 in #1215
• Fix RequiredResourceAccess cannot be an array issue in Set-AzureADMSApplication by @PenguinCats in #1229
• Remediate GUIDs per the security dashboard hits by @msewaweru in #1248
• Delete Retired .openpublishing.build.ps1 script of default branch by @shujingMS in #1244
• Enhancement: Get-EntraContext - Add Entra PowerShell version to response by @SteveMutungi254 in #1246
• Hotfix - Update-EntraBetaUserAuthenticationRequirement by @SteveMutungi254 in #1251
• 0.20.0 release - Enrich examples to boost example quality KPI - Batch 7 by @SteveMutungi254 in #1219
• 0.20.0 release - Enrich examples to boost example quality KPI - Batch 6 by @SteveMutungi254 in #1217
• 0.20.0 release - Enrich examples to boost example quality KPI - Batch 5 [domains] by @SteveMutungi254 in #1216
• 0.20.0 release - Enrich examples to boost example quality KPI - Batch 3 [devices] by @SteveMutungi254 in #1196
• 0.20.0 release - Enrich examples to boost example quality KPI - Batch 2 by @SteveMutungi254 in #1193
• 0.20.0 release - Enrich examples to boost example quality KPI - Batch 2 (users) by @SteveMutungi254 in #1189
• Update New-EntraBetaPrivateAccessApplicationSegment.md by @andres-canello in #1275
• Update .Net version| by @KenitoInc in #1298

New Contributors

• @PenguinCats made their first contribution in #1229
• @shujingMS made their first contribution in #1244

Full Changelog: 0.19.0-preview...0.20.0-preview

0.19.0-preview

Release Notes

0.19.0 - November 4, 2024

• New Global Secure Access Commands: Added four cmdlets:

  • Enable-EntraBetaGlobalSecureAccessTenant
  • New-EntraBetaPrivateAccessApplication
  • Get-EntraBetaPrivateAccessApplication
  • Get-EntraBetaGlobalSecureAccessTenantStatus

• Bug Fixes:

  • Fixed #1164: Resolved missing types in certain beta commands.
  • Fixed #1163: Removed duplicate examples.

• Enhancements:

  • Improved examples for over 130 cmdlets.
  • Enhanced directory sync features and configurations.

• Security:

  • Implemented security hardening measures in the release pipeline.

Installation instructions

Install the module from the PowerShell gallery

Install-Module -Name Microsoft.Graph.Entra -RequiredVersion 0.19.0-preview -AllowPrerelease -Repository PSGallery –Force

For beta module

Install-Module -Name Microsoft.Graph.Entra.Beta -RequiredVersion 0.19.0-preview -AllowPrerelease -Repository PSGallery –Force

What's Changed

• Update CI build agent by @KenitoInc in #1173
• Bug fix: Type fixes for beta commands - Issue #1164 by @SteveMutungi254 in #1175
• 1es release pipeline fixes by @KenitoInc in #1159
• Enrich examples to boost example quality KPI - Batch 1 by @SteveMutungi254 in #1158
• Enrich examples to boost example quality KPI - Batch 3 by @SteveMutungi254 in #1169
• Remove duplicate examples - Get-EntraUserOAuth2PermissionGrant for Issue #1163 by @SteveMutungi254 in #1174
• Enrich examples to boost example quality KPI - Batch 2 by @SteveMutungi254 in #1167
• Create customer app script enhancements by @SteveMutungi254 in #1166
• Improvements on directory sync features and configurations by @SteveMutungi254 in #1170
• Adding Global Secure Access usability parameter switches by @SteveMutungi254 in #1171
• ::: 0.19.0-release Enhancements based on customer feedback. by @SteveMutungi254 in #1172
• Updated ServicePrincipalAppRole customizations (#1161) by @alflokken in #1162
• Global Secure Access commands #2 by @andres-canello in #971
• Update to version 0.19.0 by @emmanuel-karanja in #1183

New Contributors

• @alflokken made their first contribution in #1162

Full Changelog: 0.18.0-preview...0.19.0-preview

0.18.0-preview

Release Notes

0.18.0 - October 17th, 2024

• Added usability-focused parameter switches to the Set-EntraUserLicence and Set-EntraUserPassword cmdlets.
• Fixed issue #1118: corrected parameter sets for Find-EntraPermission.
• Improved documentation quality scores for 20 cmdlets.
• Enhanced examples for 8 cmdlets.
• Implemented platform-level security hardening in the release pipeline

Installation instructions

Install the module from the PowerShell gallery

Install-Module -Name Microsoft.Graph.Entra -RequiredVersion 0.18.0-preview -AllowPrerelease -Repository PSGallery –Force

For beta module

Install-Module -Name Microsoft.Graph.Entra.Beta -RequiredVersion 0.18.0-preview -AllowPrerelease -Repository PSGallery –Force

What's Changed

• Remove trailing period on titles resulting in build warnings by @SteveMutungi254 in #1143
• Remove submodule by @KenitoInc in #1151
• Fix Find-EntraPermission to be consistent with Find-MgGraphPermission by @emmanuel-karanja in #1145
• Add example to cmdlet by @msewaweru in #1152
• Batch Acrolinx bump to over 80% score by @SteveMutungi254 in #1149
• Auto-generated baselines by 1ES Pipeline Templates by @microsoft-github-policy-service in #1132
• Missed Usability Params for 'Set-EntraUserLicence' and 'Set-EntraUserPassword' by @emmanuel-karanja in #1150
• Update Set-EntraBetaServicePrincipal.md by @msewaweru in #1146
• Documentation enhancements based on customer feedback for release 0.18.0 by @SteveMutungi254 in #1153
• Update the version to v0.18.0 by @emmanuel-karanja in #1157

Full Changelog: 0.17.0-preview...0.18.0-preview

0.17.0-preview

Release Notes

0.17.0 - October 3rd, 2024

• Introduced usability parameter switches for over 480 cmdlets.
• Added a new cmdlet: Set-EntraDirSyncEnabled.
• Resolved issue #1106 – corrected indentation errors.
• Resolved issue #1110 – added proper command examples to Help Synopsis.
• Resolved issue #1112 – provided missing parameter descriptions in Help Synopsis.
• Added unit tests for 48 cmdlets.
• Enriched examples for more than 15 cmdlets.

Installation instructions

Install the module from the PowerShell gallery

Install-Module -Name Microsoft.Graph.Entra -RequiredVersion 0.17.0-preview -AllowPrerelease -Repository PSGallery –Force

For beta module

Install-Module -Name Microsoft.Graph.Entra.Beta -RequiredVersion 0.17.0-preview -AllowPrerelease -Repository PSGallery –Force

What's Changed

• added unit test for New-EntraServicePrincipal and New-EntraServicePri… by @snehalkotwal in #756
• Policy Unit Testing by @v-akarke in #751
• added mock test cases for Remove-EntraServicePrincipalPasswordCredent… by @snehalkotwal in #761
• added unit script for Set-EntraServicePrincipal and Select-EntraGroup… by @snehalkotwal in #762
• Common-parameters-UT by @v-akarke in #1021
• Unit-Tests by @v-ymundhe in #1029
• Unit tests by @v-ymundhe in #1030
• mock test cases for contact by @snehalkotwal in #1036
• updated mock test cases by @snehalkotwal in #1041
• Added mock test for Get-EntraServiceAppRoleAssigne,Get-EntraServiceAp… by @snehalkotwal in #754
• added mock test cases by @snehalkotwal in #1039
• Unit Testing by @snehalkotwal in #763
• added msol tests by @v-uansari in #787
• Bugfix-1082 by @v-akarke in #1091
• added msol unit test cases by @snehalkotwal in #783
• moved extra proxy docs to future folder by @v-pughosh in #1107
• Entra cmdlet mock test cases by @snehalkotwal in #1096
• updated mock test cases by @snehalkotwal in #1105
• Added beta mock test cases by @snehalkotwal in #1103
• Integration tests pipeline by @KenitoInc in #1124
• updated main branch test cases for missing headers by @snehalkotwal in #1111
• Get entra partner information docs by @snehalkotwal in #1109
• 1ES CI pipeline by @KenitoInc in #1125
• Get-EntraAuthorizationPolicy by @v-akarke in #1121
• Updated UserThumbnailPhoto doc to remove missing parameters by @snehalkotwal in #1123
• Updating Description for the module metadata by @SteveMutungi254 in #1122
• Fixed error message for unsupported command by @merill in #1128
• Fixes for Issue: #1110 and #1112 by @HCRitter in #1113
• Fixing bad examples by @SteveMutungi254 in #1127
• Confirm-EntraBetaDomain by @v-akarke in #1117
• Credscan fixes by @SteveMutungi254 in #1131
• Set-MsolDirSyncEnabled cmd by @v-uansari in #1115
• Restore-EntraBetaDeletedDirectoryObject by @v-akarke in #1071
• 1es release pipeline by @KenitoInc in #1134
• Update integration tests pipeline by @KenitoInc in #1135
• Make CI pipeline official by @KenitoInc in #1137
• Release 0.17.0-prerelease Improvements by @SteveMutungi254 in #1100
• Usability-Parameters by @v-akarke in #1050
• Hot Fix Restore entra beta deleted directory object by @v-uansari in #1136
• Sample scripts for creating a custom enterprise application by @SteveMutungi254 in #1138
• Fixing indentation for Entra PS v1.0 commands by @SteveMutungi254 in #1130
• Removed white space to fix indentation issue for Beta commands. by @SteveMutungi254 in #1129
• Update to version 0.17.0 by @emmanuel-karanja in #1141

New Contributors

• @merill made their first contribution in #1128
• @HCRitter made their first contribution in #1113

Full Changelog: 0.16.0-preview...0.17.0-preview

0.16.0-preview

Release Notes

0.16.0 - September 19th, 2024

• Added a new cmdlet: Reset-EntraStrongAuthenticationMethodByUpn.
• Fixed issue #1090 where Get-EntraUserManager ignored the Property parameter.
• Fixed broken links in the Remove-EntraFeatureRolloutPolicyDirectoryObject documentation.
• Updated documentation for 300+ cmdlets to align with both Beta and v1.0 versions.
• Upgraded the pipeline to the latest version 5 of the Engineering Security and Release Platform (ESRP) for the CI/CD pipeline.
• Added a sample script for retrieving Entitlement-assignment-policies-without-approval.
• Added 28 cmdlet aliases for backward compatibility.
• Included examples for removing licenses in Set-EntraUserLicense.
• Added unit tests for 48 commands.

Installation instructions

Install the module from the PowerShell gallery

Install-Module -Name Microsoft.Graph.Entra -RequiredVersion 0.16.0-preview -AllowPrerelease -Repository PSGallery –Force

For beta module

Install-Module -Name Microsoft.Graph.Entra.Beta -RequiredVersion 0.16.0-preview -AllowPrerelease -Repository PSGallery –Force

What's Changed

• remove related link by @snehalkotwal in #1062
• Add empty OneBranchCI yml by @KenitoInc in #1064
• ESRP v5 by @KenitoInc in #1067
• OneBranch CI Build by @KenitoInc in #1069
• Create identify-assignment-policies-without-approval.ps1 by @AlexFilipin in #1060
• Docs improvement for 0.16.0 preview release batch one by @SteveMutungi254 in #1052
• Docs improvement for 0.16.0 preview release batch two by @SteveMutungi254 in #1070
• updated doc for entra and beta by @snehalkotwal in #1086
• Docs improvement for 0.16.0 preview release batch three by @SteveMutungi254 in #1076
• Docs improvement for 0.16.0 preview release batch four by @SteveMutungi254 in #1077
• Docs improvement for 0.16.0 preview release batch five by @SteveMutungi254 in #1078
• Docs improvement for 0.16.0 preview release batch six by @SteveMutungi254 in #1079
• Docs improvement for 0.16.0 preview release batch seven by @SteveMutungi254 in #1080
• Docs improvement for 0.16.0 preview release batch eight by @SteveMutungi254 in #1081
• Docs improvement for 0.16.0 preview release batch nine by @SteveMutungi254 in #1084
• Docs improvement for 0.16.0 preview release batch ten by @SteveMutungi254 in #1085
• Update module metadata like downloads, supported platforms by @SteveMutungi254 in #1072
• Cmdlets Aliases by @v-akarke in #1056
• added mock test by @snehalkotwal in #737
• Get-EntraUserLicenseDetail unit testing by @v-uansari in #743
• Added Remove Example - Set-EntraUserLincense by @v-akarke in #1094
• Unit Testing (EntraUserManager) by @v-uansari in #747
• Mock test for Add-EntraServicePrincipalOwner by @snehalkotwal in #749
• Mocktest1204 by @snehalkotwal in #700
• Upcoming version 0.16.0 preview enhancements by @SteveMutungi254 in #1057
• Added mock tests by @snehalkotwal in #752
• Reset-EntraStrongAuthenticationMethodByUpn by @v-akarke in #535
• Fix Get-EntraUserManager Property param implementation by @KenitoInc in #1099
• Update manifest generation to remove * and replace with @() by @emmanuel-karanja in #1097
• Update version to 0.16.0-preview by @KenitoInc in #1098

New Contributors

• @AlexFilipin made their first contribution in #1060

Full Changelog: 0.15.0-preview...0.16.0-preview

0.15.0-preview

Release Notes

0.15.0 - September 5th 2024

• Added six new cmdlets: FeatureRolloutPolicy, TrustedCertificateAuthority, and CustomSecurityAttributeDefinitionAllowedValue.
• Renamed over 40 cmdlets to follow PowerShell cmdlet naming best practices, ensuring singular nouns are used.
• Removed unused variables as part of code clean-up efforts.
• Added a developer documentation guide that covers development workflow, cmdlet best practices, pipeline best practices, and parameter best practices.
• Updated configuration to manage the required version for dependent modules.
• Enabled PSScriptAnalyzer for code analysis.
• Housekeeping tasks, including improvements to the build and release pipelines.

Installation instructions

Install the module from the PowerShell gallery

Install-Module -Name Microsoft.Graph.Entra -RequiredVersion 0.15.0-preview -AllowPrerelease -Repository PSGallery –Force

For beta module

Install-Module -Name Microsoft.Graph.Entra.Beta -RequiredVersion 0.15.0-preview -AllowPrerelease -Repository PSGallery –Force

What's Changed

• Add release pipeline by @KenitoInc in #980
• Kemunga/fix release pipeline by @KenitoInc in #1034
• Hotfix-New-EntraBetaApplication by @v-ymundhe in #1026
• Removed the mention of ROPC inline with SFI guidance by @msewaweru in #1037
• Removed unused var by @v-uansari in #1015
• Remove-EntraFeatureRolloutPolicyDirectoryObject by @v-akarke in #926
• Get-EntraCustomSecurityAttributeDefinitionAllowedValue by @v-akarke in #826
• Documentation improvements for 0.15.0-prerelease Batch One by @SteveMutungi254 in #1038
• Get-EntraTrustedCertificateAuthority/Get-EntraBetaTrustedCertificateAuthority : fixed CertificateAuthorities error issue by @v-akarke in #1024
• Set-EntraFeatureRolloutPolicy by @v-akarke in #913
• Remove-EntraFeatureRolloutPolicy by @v-akarke in #917
• Docs improvement for 0.15.0 preview release batch two by @SteveMutungi254 in #1040
• Create standard release pipeline by @KenitoInc in #1035
• Specify required version for dependent modules by @KenitoInc in #1045
• Developer documentation guide by @SteveMutungi254 in #1011
• Enable PSScriptAnalyzer by @KenitoInc in #972
• Docs improvement for 0.15.0 preview release batch three by @SteveMutungi254 in #1042
• Docs improvement for 0.15.0 preview release batch four by @SteveMutungi254 in #1043
• Beta commands converted to use API to make consistency by @v-uansari in #1025
• Docs improvement for 0.15.0 preview release batch five by @SteveMutungi254 in #1046
• Docs improvement for 0.15.0 preview release batch six by @SteveMutungi254 in #1047
• Get-EntraFeatureRolloutPolicy by @v-akarke in #896
• Updating module labels. by @SteveMutungi254 in #1049
• Cmdlets renaming and Aliases by @v-akarke in #1033
• update preview-release version to 0.15.0 by @emmanuel-karanja in #1051

Full Changelog: 0.14.0-preview...0.15.0-preview