Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

v3.0.0 #24

Merged
merged 5 commits into from
Jan 13, 2023
Merged

v3.0.0 #24

merged 5 commits into from
Jan 13, 2023

Conversation

GruberMarkus
Copy link
Owner

v3.0.0 - 2023-01-13

Breaking: Microsoft removes support for Remote PowerShell connections to Exchange Online starting June 1, 2023. See https://techcommunity.microsoft.com/t5/exchange-team-blog/announcing-deprecation-of-remote-powershell-rps-protocol-in/ba-p/3695597 for details.
Export-RecipientPermissions no longer uses Remote PowerShell to connect to Exchange Online and to Exchange on-premises. This brings some possibly breaking changes, which are detailed in the following release notes.

Changed

  • Breaking: Switching from Remote PowerShell session to local PowerShell session due Microsoft disabling Remote PowerShell in Exchange Online
    • Export-RecipientPermission will require more local resources (CPU, RAM, network) and will take longer to complete because operations previously handled on the server side now need to be handled on the client side
    • The variables '$Grantor' and '$Trustee' lose some sub attributes, so you may have to adopt your 'GrantorFilter' and 'TrusteeFilter' code:
      • '.RecipientType.Value' is now '.RecipientType'
      • '.RecipientTypeDetails.Value' is now '.RecipientTypeDetails'
      • '.PrimarySmtpAddress' no longer has the sub attributes .Local, .Domain and .Address
        • All the data formerly held in the sub attributes is still there, as .PrimarySmtpAddress is in the 'local@domain' format
      • '.EmailAddresses' (an array) no longer has the sub attributes .PrefixString, .IsPrimaryAddress, .SmtpAddress and .ProxyAddressString
        • All the data formerly held in the sub attributes is still there, as .EmailAddress is in the 'prefix:local@domain' format
      • On-prem only:
        • '.Identity' is now the canonical name (CN) only and no longer has the sub attributes .DomainId and .Parent
          • All the data formerly held in the sub attributes is still there, as .Identity is in the 'example.com/OU1/OU2/ObjectA' format
    • Reduced the default value of 'ParallelJobsExchange' from '$ExchangeConnectionUriList.count * 3' to '$ExchangeConnectionUriList.count' as local Exchange PowerShell sessions are not as stable as Remote PowerShell sessions
  • Adopted sample code and documentation to reflect changes in the '$Grantor' and '$Trustee' variables
  • Use Get-EXO* cmdlets in Exchange Online where possible
  • Upgrade to ExchangeOnlineManagement v3.1.0

Added

  • New export parameters: 'ExportModerators', 'ExportRequireAllSendersAreAuthenticated', 'ExportAcceptMessagesOnlyFrom', 'ExportResourceDelegates'. See 'README' for details.
  • New FAQ in 'README': 'I receive an error message when connecting to Exchange on premises'

Fixed

  • When importing UserFriendlyNames, errors were not written to the error file because of a missing encoding variable
  • Only the first ManagedBy entry for reach recipient was exported correctly, the following entries were missing trustee data

@GruberMarkus GruberMarkus merged commit 68cc263 into main Jan 13, 2023
@GruberMarkus GruberMarkus deleted the develop branch January 13, 2023 11:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant