Release v2.3.1

v2.3.1 - 2022-11-28

Added

• New FAQ in 'README': 'How to export permissions for specific public folders?'

Fixed

• Sample code 'compare.ps1' now additionally outputs the original identity of a trustee and not only the primary SMTP address. This helps with permissions granted to 'Anonymous' and 'Default', as well as with recipients which have been deleted in the time between the old and the new export.
• Always include trustee groups in 'GrantorFilter' when 'ExportDistributionGroups' is set to 'OnlyTrustees'

File hashes

• SHA256 hash of 'Export-RecipientPermissions_v2.3.1.zip': 5F7956E0B4560A42C24CB093CCDC1A8CDB1F69698B3137696E237708972BEA6B
• See 'hashes.txt' in 'Export-RecipientPermissions_v2.3.1.zip' for hash value of every single file in the release.

Release v2.3.0

v2.3.0 - 2022-10-25

Added

• When 'ExportFromOnPrem' is set to '$true' and 'ExchangeConnectionUriList' is not specified, 'ExchangeConnectionUriList' defaults to 'http://<server>/powershell' for each Exchange server with the mailbox server role
• New FAQs in 'README': 'Which resources does a particular user or group have access to?', 'How to find distribution lists without members?'
• New sample code 'MemberOfRecurse.ps1'

File hashes

• SHA256 hash of 'Export-RecipientPermissions_v2.3.0.zip': 37104E9A7F937C7E0F6F9C7C46939CBA32C474F9055658CAB8E8C8ADD2900419
• See 'hashes.txt' in 'Export-RecipientPermissions_v2.3.0.zip' for hash value of every single file in the release.

Release v2.2.1

v2.2.1 - 2022-09-27

Fixed

• When ExportGrantorsWithNoPermissions is enabled and ExportGuids is disabled, empty management role groups were exported with no name and a trailing slash in the recipient type field
• Some major tasks did not show a timestamp, but rather the PowerShell code generating the timestamp
• ExpandGroups did not work for groups which were not part of the grantor filter
• Mailbox access rights now correctly show data for trustees identified via linked master account

File hashes

• SHA256 hash of 'Export-RecipientPermissions_v2.2.1.zip': 8409AB3757387B87A3A4E2464D39B44427C0FF59C478941A6BA5F108C9CEC7A4
• See 'hashes.txt' in 'Export-RecipientPermissions_v2.2.1.zip' for hash value of every single file in the release.

Release v2.2.0

v2.2.0 - 2022-09-21

Changed

• Updated 'README' to correctly document value names (.RecipientType.Value, .RecipientTypeDetails.Value) (#14) (Thanks @snurbnacnud!)
• Bump ExchangeOnlineMangement to v3.0.0

Added

• New parameter 'ExportGrantorsWithNoPermissions', see 'README' for details
• New parameter 'ExportGuids', see 'README' for details
• New parameter 'ExportGroupMembersRecurse', see 'README' for details
• New FAQ in 'README': Is there a GUI available?
• Parallelize combination of temporary result files to final result file
• Parallelize import of direct group members
• Export-RecipientPermissions now has a logo and an icon

Fixed

• Incorrect escape of double quotes in CSV files

File hashes

• SHA256 hash of 'Export-RecipientPermissions_v2.2.0.zip': 3B9D01AB5259B1830BC9C02FF863C59CB367C7E17359499A5F97E82AF54FDB38
• See 'hashes.txt' in 'Export-RecipientPermissions_v2.2.0.zip' for hash value of every single file in the release.

Release v2.1.0

v2.1.0 - 2022-09-05

Changed

• Importing recipients is now a multi-thred Exchange operation. Recipients are queried by lots of small queries to avoid problems with missing data in big environments.

Added

• New parameter 'ExpandGroups': If a trustee is a group, get the group's recursive members and export the granted permission for each individual member. See 'README' for details and comparison to 'ExportDistributionGroupMembers'.
• New parameter 'ExportDistributionGroupMembers': Export recursive distribution group members, including nested groups and dynamic groups. See 'README' for details and comparison to 'ExpandGroups'.
• The new parameter 'ExportFileFilter' allows filtering the final results before they are written to the export file. See 'README' for details.
• Special mailboxes are now added to the recipients list. This includes Arbitration, AuditLog, AuxAuditLog, inactive, Migration, Monitoring, RemoteArchive and softdeleted mailboxes (some of them are only available in on-prem or cloud environments)
• Mailbox permissions exported from the cloud now include softdeleted and unresolved trustees

File hashes

• SHA256 hash of 'Export-RecipientPermissions_v2.1.0.zip': 637771F73EDFA82C5FA88A2F02F67976B12AC15D09787BF1F9921B6E04747680
• See 'hashes.txt' in 'Export-RecipientPermissions_v2.1.0.zip' for hash value of every single file in the release.

Release v2.1.0-alpha1

v2.1.0-alpha1 - 2022-08-17

Changed

• Importing recipients is now a multi-thred Exchange operation. Recipients are queried by lots of small queries to avoid problems with missing data in big environments.

Added

• New parameter 'ExpandGroups': If a trustee is a group, get the group's recursive members and export the granted permission for each individual member. See 'README' for details and comparison to 'ExportDistributionGroupMembers'.
• New parameter 'ExportDistributionGroupMembers': Export recursive distribution group members, including nested groups and dynamic groups. See 'README' for details and comparison to 'ExpandGroups'.
• The new parameter 'ExportFileFilter' allows filtering the final results before they are written to the export file. See 'README' for details.
• Special mailboxes are now added to the recipients list. This includes Arbitration, AuditLog, AuxAuditLog, inactive, Migration, Monitoring, RemoteArchive and softdeleted mailboxes (some of them are only available in on-prem or cloud environments)
• Mailbox permissions exported from the cloud now include softdeleted and unresolved trustees

File hashes

• SHA256 hash of 'Export-RecipientPermissions_v2.1.0-alpha1.zip': 74FF0C8B1CDCFDFD8C0438DF49A5D720B19968EB27D07FE7938D671346A7AEDF
• See 'hashes.txt' in 'Export-RecipientPermissions_v2.1.0-alpha1.zip' for hash value of every single file in the release.

Release v2.0.0

v2.0.0 - 2022-07-19

Breaking: See 'Changed' section for breaking changes

Changed

• Breaking: New default values for several parameters:
  • 'ExportMailboxFolderPermissions': '$false'
  • 'ExportMailboxFolderPermissionsAnonymous': '$true'
  • 'ExportMailboxFolderPermissionsDefault': '$true'
• The GrantorFilter parameter can now only use the reference variable '$Grantor' and no longer '$Recipient'. This change has been announced with the release v1.5.0.

Added

• The new parameter 'RecipientProperties' controls which recipient properties are loaded and can then be used in 'GrantorFilter' and 'TrusteeFilter'. It also helps keep network traffic and memory usage low. See 'README' for details.
• Mail-enabled public folders are now considered when exporting Send As and Send On Behalf permissions
• Export of public folder permissions. See 'README' for details regarding the new parameters 'ExportPublicFolderPermissions', 'ExportPublicFolderPermissionsAnonymous', 'ExportPublicFolderPermissionsDefault' and 'ExportPublicFolderPermissionsExcludeFoldertype'.
• Export management role group permissions. See 'README' for new parameter 'ExportManagementRoleGroupMembers'.
• Export forwarders. See 'README' for details regarding the 'ExportForwarders' parameter.
• The sample file 'Export-RecipientPermissions_Result.csv' shows a typical result file of Export-RecipientPermissions
• New FAQs 'Which permissions are required?' and 'Can the script resolve permissions granted to a group to it's individual members?' in 'README'

Fixed

• Export all Send As permissions, not only the one granted by the last recipient checked by each parallel job

File hashes

• SHA256 hash of 'Export-RecipientPermissions_v2.0.0.zip': 4CF2E0E980A8B8B7F75290729200FCCDCD3FF455F0C6FFEF879194D9051E5285
• See 'hashes.txt' in 'Export-RecipientPermissions_v2.0.0.zip' for hash value of every single file in the release.

Release v2.0.0-beta1

v2.0.0-beta1 - 2022-07-09

Breaking: See 'Changed' section for breaking changes

Changed

• Breaking: New default values for several parameters:
  • 'ExportMailboxFolderPermissions': '$false'
  • 'ExportMailboxFolderPermissionsAnonymous': '$true'
  • 'ExportMailboxFolderPermissionsDefault': '$true'
• The GrantorFilter parameter can now only use the reference variable '$Grantor' and no longer '$Recipient'. This change has been announced with the release v1.5.0.

Added

• The new parameter 'RecipientProperties' controls which recipient properties are loaded and can then be used in 'GrantorFilter' and 'TrusteeFilter'. It also helps keep network traffic and memory usage low. See 'README' for details.
• Mail-enabled public folders are now considered when exporting Send As and Send On Behalf permissions
• Export of public folder permissions. See 'README' for details regarding the new parameters 'ExportPublicFolderPermissions', 'ExportPublicFolderPermissionsAnonymous', 'ExportPublicFolderPermissionsDefault' and 'ExportPublicFolderPermissionsExcludeFoldertype'.
• Export management role group permissions. See 'README' for new parameter 'ExportManagementRoleGroupMembers'.
• Export forwarders. See 'README' for details regarding the 'ExportForwarders' parameter.
• The sample file 'Export-RecipientPermissions_Result.csv' shows a typical result file of Export-RecipientPermissions

Fixed

• Export all Send As permissions, not only the one granted by the last recipient checked by each parallel job

File hashes

• SHA256 hash of 'Export-RecipientPermissions_v2.0.0-beta1.zip': 31ECBD7D14A5E793920DB356BC57A3B10526F9453B3500CE906EA0F272AA51E4
• See 'hashes.txt' in 'Export-RecipientPermissions_v2.0.0-beta1.zip' for hash value of every single file in the release.

Release v1.5.1

v1.5.1 - 2022-06-27

Fixed

• Make sure non-working Exchange Online connections are properly closed and do not remain active in the background

File hashes

• SHA256 hash of 'Export-RecipientPermissions_v1.5.1.zip': 4027CBCD42613EDC5265E46F6AF72CDB08FDC4D89C1CC660114412D28E3D13F5
• See 'hashes.txt' in 'Export-RecipientPermissions_v1.5.1.zip' for hash value of every single file in the release.

Release v1.5.0

v1.5.0 - 2022-06-25

Changed

• The GrantorFilter parameter can now use the new reference variable '$Grantor' in addition to '$Recipient'. Both reference variables have identical values. '$Recipient' is now marked as obsolete and may removed in a future release.

Added

• New parameter 'GrantorFilter': Filter the trustees included in the export. See 'README' for details.
• New sample code 'FiltersAndSidhistory.ps1' shows how to use TrusteeFilter and GrantorFilter to find permissions which may be affected by SIDHistory removal.
• The connection to the cloud now uses the Exchange Online PowerShell V2 module (a preview version is used which allows traditional remote PowerShell access to all cmdlets). See '.\README' for details about the required 'ExchangeOnlineConnnectionParameters' parameter.

File hashes

• SHA256 hash of 'Export-RecipientPermissions_v1.5.0.zip': A1A2E8030D5AC35BA7DF3A8AD0B56C8851DFF3952ECA87905F8E115E167B3F52
• See 'hashes.txt' in 'Export-RecipientPermissions_v1.5.0.zip' for hash value of every single file in the release.