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.

Release v1.4.0

v1.4.0 - 2022-05-24

Added

• New parameter 'ExportLinkedMasterAccount': Export the configured linked master account of mailboxes as permission. See 'README' for details.
• Permissions granted to a trustee which has a linked master account are now resolved against the list of recipients
• New parameter 'ExportTrustees': Export all trustees, or only those can can or can not be resolved to a recipient. See 'README' for details.
• Non-unique LinkedMasterAccounts, UserFriendlyNames, DistinguishedNames, GUIDs and PrimarySmtpAddresses are shown in verbose stream. When one of these attributes is not unique, a trustee can not be matched against just one recipient, so the corresponding details in the report are empty.
• Added automatic retry of last command not only in case of an error related to the command itself, but also when the error is related to the underlying Exchange connection
• Added FAQs in 'README' file

Fixed

• The mailbox GUID is no longer always blank in the error message indicating a connection error to a mailbox

File hashes

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

Release v1.3.0

v1.3.0 - 2022-03-06

Added

• New parameter 'UseDefaultCredential'

File hashes

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