diff --git a/.gitattributes b/.gitattributes index 061fdd6..aa4847f 100644 --- a/.gitattributes +++ b/.gitattributes @@ -61,6 +61,7 @@ package/docs/images/console-task-check-light.png -text package/docs/images/console-task-continue-light.png -text package/docs/images/console-task-finalize-light.png -text package/docs/images/console-task-finish-light.png -text +package/docs/images/console-task-group-light.png -text package/docs/images/console-task-identity-light.png -text package/docs/images/console-task-light.png -text package/docs/images/console-task-package-selected-light.png -text diff --git a/CHANGELOG.md b/CHANGELOG.md index 473719b..6a00d31 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,19 @@ All notable changes of PRA Remote Mailbox. Author: Nicolas Fabert. Versions foll a MAJOR version changes the command line or the configuration file, a MINOR version adds a feature, a PATCH version fixes a defect. The backup formats have their own version (see the guide, annex D). +## 3.1.3 — 2026-11-12 + +### Added +- Convert the members of an AD group for one run (`-Group `, or **AD group** in the console Task page): nested groups included, every member not converted listed with its reason. + +### Fixed +- Every value you type or pick ignores letter case (parameters, configuration values, Environment, CSV, batch and package names). +- The install commands given by the tool and the guides work (one `Install-Module` per module). +- A run refused before any change shows 0 done and writes no global report; an answer "no" ends `RESULT: CANCELLED`. A Preview says "ready" and "planned", never "done". +- Every failed run ends with a next step and a command that works: refused options, a refused AD write, an unreachable domain controller, a cloud wait that timed out, an object already converted (its current batch). +- Two servers: copy the zip **and** its `.sha256` file; the rollback command after a cloud step is the AD phase. +- Plain messages for a failed Entra Connect cycle, a Check and the Exchange Online session check. The Setup page shows one "Cloud modules" light. + ## 3.1.2 — 2026-11-10 ### Fixed diff --git a/README.md b/README.md index c0502fd..f176475 100644 --- a/README.md +++ b/README.md @@ -21,7 +21,7 @@

> [!TIP] -> **Download the latest release.** Open the [latest release](https://github.com/Nico77600/PraRemoteMailbox/releases/latest) and download **`PraRemoteMailbox-3.1.2.zip`** under *Assets* (its SHA-256 is in the release notes). That ZIP is the signed tool, with the HTML guides. Do not use the **Source code** archives or the green **Code** button: they are a copy of the repository, not the release package. +> **Download the latest release.** Open the [latest release](https://github.com/Nico77600/PraRemoteMailbox/releases/latest) and download **`PraRemoteMailbox-3.1.3.zip`** under *Assets* (its SHA-256 is in the release notes). That ZIP is the signed tool, with the HTML guides. Do not use the **Source code** archives or the green **Code** button: they are a copy of the repository, not the release package. > [!IMPORTANT] > Files downloaded from the Internet may be blocked by Windows and fail to run. Before using this project, unblock every file in the downloaded folder: @@ -48,7 +48,7 @@ In a hybrid organisation, a mailbox hosted on-premises is only a *mail user* for Done by hand, this means rewriting about ten Exchange attributes per object in Active Directory, for hundreds of objects, under stress — and keeping every original value to come back later: a wrong or lost value cannot be repaired without a backup. This tool does the conversion in a planned, verified and **reversible** way. -**Author:** Nicolas Fabert · **Version:** 3.1.2, 2026-11-10 ([changelog](CHANGELOG.md)). +**Author:** Nicolas Fabert · **Version:** 3.1.3, 2026-11-10 ([changelog](CHANGELOG.md)). > [!CAUTION] > Convert creates **new, empty** mailboxes in Exchange Online: the content of the on-premises mailboxes is not moved. A Recover deprovisions the cloud mailboxes: export first what was received in the cloud during the disaster, or protect it with a retention policy (reference guide, chapter 6). @@ -68,10 +68,11 @@ One path for everyone. Set the tool up once (**1 to 4**), then take branch **A** # 1 · Get your rights. Give the table "Requirements" below to your administrator (minimum rights, derived from the code). # 2 · On the server, in PowerShell 7.5+ as administrator: put the tool in its folder and unblock it. -# Download PraRemoteMailbox-3.1.2.zip from the latest release (under Assets, not Source code) and extract it to D:\PRA\PraRemoteMailbox +# Download PraRemoteMailbox-3.1.3.zip from the latest release (under Assets, not Source code) and extract it to D:\PRA\PraRemoteMailbox Get-ChildItem D:\PRA\PraRemoteMailbox -Recurse -File -Force | Unblock-File Install-Module ExchangeOnlineManagement -MinimumVersion 3.10.1 -Scope AllUsers -Force -Install-Module Microsoft.Graph.Authentication, Microsoft.Graph.Users -MinimumVersion 2.41.1 -Scope AllUsers -Force +Install-Module Microsoft.Graph.Authentication -MinimumVersion 2.41.1 -Scope AllUsers -Force # one command per module: PowerShellGet refuses -MinimumVersion with several names +Install-Module Microsoft.Graph.Users -MinimumVersion 2.41.1 -Scope AllUsers -Force # 3 · Fill in the settings: scope, licence group, routing domain, Entra Connect server, tenant notepad D:\PRA\PraRemoteMailbox\config\PraRemoteMailbox.config.psd1 diff --git a/package/Invoke-PraRemoteMailbox.ps1 b/package/Invoke-PraRemoteMailbox.ps1 index 352765a..ab9a86b 100644 --- a/package/Invoke-PraRemoteMailbox.ps1 +++ b/package/Invoke-PraRemoteMailbox.ps1 @@ -67,6 +67,12 @@ Convert AD/Both only: select a CSV with an Identity column for this run (comma or semicolon). Overrides the configured scope without rewriting it. Cannot be combined with Identity or SearchBase. +.PARAMETER Group + Convert AD/Both only: take the members of one Active Directory group for this run, given by its name (sAMAccountName or CN) or its + distinguished name. The members of nested groups are included. Computers, contacts and users without an on-premises mailbox are not converted: + each is listed as skipped with its reason. Overrides the configured scope without rewriting it. Cannot be combined with Identity, SearchBase + or CsvPath. A name that matches no group or several groups is refused. + .PARAMETER MaxObjects Convert: process at most N objects (after sorting by sAMAccountName). 0 = no limit. @@ -120,6 +126,10 @@ .\Invoke-PraRemoteMailbox.ps1 -Action Convert -Mode Apply -Identity user01@contoso.com -WhatIf -WhatIf always means Preview, even with -Mode Apply. +.EXAMPLE + .\Invoke-PraRemoteMailbox.ps1 -Action Convert -Group PRA-Wave1 + Preview of the conversion of the members of the group PRA-Wave1 (nested groups included), whatever the configured scope says. + .EXAMPLE .\Invoke-PraRemoteMailbox.ps1 -Action Recover -Mode Apply -Batch 490cc62e Rolls back the Convert batch 490cc62e. @@ -139,7 +149,7 @@ .NOTES Author : Nicolas Fabert - Version : 3.1.2 + Version : 3.1.3 Requires : PowerShell 7.5 or later (pwsh.exe; Windows PowerShell 5.1 is refused), RSAT ActiveDirectory, ExchangeOnlineManagement 3.10.1+, Microsoft.Graph.Authentication and Microsoft.Graph.Users 2.41.1+ in one same version (cloud part), ADSync (sync; through the Windows PowerShell compatibility layer when local). @@ -166,6 +176,7 @@ param( [Parameter(ParameterSetName = 'Run')][string]$Identity, [Parameter(ParameterSetName = 'Run')][string]$SearchBase, [Parameter(ParameterSetName = 'Run')][string]$CsvPath, + [Parameter(ParameterSetName = 'Run')][string]$Group, [Parameter(ParameterSetName = 'Run')][ValidateSet('All','UsersOnly','SharedOnly')][string]$Scope = 'All', [Parameter(ParameterSetName = 'Run')][ValidateRange(0, 2147483647)][int]$MaxObjects = 0, [Parameter(ParameterSetName = 'Run')][ValidateSet('Provisioned','Deprovisioned','Retained')][string]$Expect = 'Provisioned', @@ -201,13 +212,12 @@ $ProgressPreference = 'SilentlyContinue' & $verifier -Root $PackageRoot } $PSScriptRoot # <<< PRA package integrity bootstrap -# Not a parameter default (kept from 2.x, where Windows PowerShell 5.1 left $PSScriptRoot empty in param() defaults under -# -File): the default path is computed here. An explicit -ConfigPath is unchanged ($script:ConfigPathBound). +# Not a parameter default: the default path is computed here. An explicit -ConfigPath is unchanged ($script:ConfigPathBound). if (-not $ConfigPath) { $ConfigPath = Join-Path $PSScriptRoot 'config\PraRemoteMailbox.config.psd1' } # ValidateSet accepts any casing (-Action convert) but binds the value AS TYPED, while the proof, batch and journal # checks of the modules compare the official spelling, ordinally (a tampered file must not pass). -# Rewrite every ValidateSet string parameter to its official spelling NOW, before anything reads it; the -# downstream comparisons stay exactly as strict as they were. ValidateSet itself uses the CULTURE comparison (ICU): it also accepts +# Every ValidateSet string parameter is rewritten to its official spelling before anything reads it, so the downstream +# comparisons can be strict. ValidateSet itself uses the culture comparison (ICU): it also accepts # "Apply" or "Apply". The lookup below is ordinal (case-insensitive) and refuses any value that has no ordinal match. foreach ($parameterInfo in $MyInvocation.MyCommand.Parameters.Values) { if ($parameterInfo.ParameterType -ne [string]) { continue } @@ -278,6 +288,7 @@ $context = @{ $context.Approval = New-PraApprovalCallback $caller $context # Lets the modules write a command line of this run's own style (-ConfigPath kept) in a message; defined here because Get-PraCommandLine is a function of this script. $context.CommandLineFor = { param([string]$ActionName, [string]$PhaseName, [string]$BatchId) Get-PraCommandLine -ActionName $ActionName -PhaseName $PhaseName -BatchId $BatchId } +$context.GroupCommandLineFor = { param([string]$GroupName) Get-PraCommandLine -ActionName $Action -PhaseName $effectivePhase -ModeName $effectiveMode -KeepFilters -Only Group -GroupName $GroupName } # ================================================================================================= # Helper functions of the entry script (they use $context). @@ -300,17 +311,25 @@ function ConvertTo-PraLiteral { function Get-PraCommandLine { <# Command line suggested in "Next step", with the options of this run that still apply. Every free-text value is quoted as data. #> - param([string]$ActionName, [string]$ModeName = 'Apply', [string]$PhaseName = '', [string]$BatchId = '', [switch]$KeepFilters, [switch]$OtherServer) + param([string]$ActionName, [string]$ModeName = 'Apply', [string]$PhaseName = '', [string]$BatchId = '', [switch]$KeepFilters, [switch]$OtherServer, + [ValidateSet('', 'Identity', 'SearchBase', 'CsvPath', 'Group', 'None')][string]$Only = '', [string]$GroupName = '') $parts = @('.\Invoke-PraRemoteMailbox.ps1', "-Action $ActionName") + # With -Only, the one object selector kept (-Identity, -SearchBase, -CsvPath or -Group; None keeps no selector): the others are left out. + $keepSelector = { param([string]$Name) (-not $Only) -or (Test-PraOrdinalIgnoreCaseEqual $Only $Name) } if ($PhaseName) { $parts += "-Phase $PhaseName" } if ((Test-PraOrdinalIgnoreCaseEqual $ModeName 'Apply')) { $parts += '-Mode Apply' } if ($BatchId) { $parts += $(if ($BatchId -match '^[0-9a-fA-F]+$') { "-Batch $BatchId" } else { '-Batch ' + (ConvertTo-PraLiteral $BatchId) }) } if ($KeepFilters) { - if ($Identity) { $parts += '-Identity ' + (ConvertTo-PraLiteral $Identity) } + if ($Identity -and (& $keepSelector 'Identity')) { $parts += '-Identity ' + (ConvertTo-PraLiteral $Identity) } if ((-not (Test-PraOrdinalIgnoreCaseEqual $Scope 'All'))) { $parts += "-Scope $Scope" } if ($MaxObjects -gt 0) { $parts += "-MaxObjects $MaxObjects" } - if ($SearchBase) { $parts += '-SearchBase ' + (ConvertTo-PraLiteral $SearchBase) } - if ($CsvPath) { $parts += '-CsvPath ' + (ConvertTo-PraLiteral $CsvPath) } + if ($SearchBase -and (& $keepSelector 'SearchBase')) { $parts += '-SearchBase ' + (ConvertTo-PraLiteral $SearchBase) } + $groupValue = if ($GroupName) { $GroupName } else { $Group } + if ($groupValue -and (& $keepSelector 'Group')) { $parts += '-Group ' + (ConvertTo-PraLiteral $groupValue) } + # On another server the CSV file is a file of that server: only its name is written, the operator copies the file there. + if ($CsvPath -and (& $keepSelector 'CsvPath')) { $parts += '-CsvPath ' + (ConvertTo-PraLiteral $(if ($OtherServer) { [IO.Path]::GetFileName($CsvPath) } else { $CsvPath })) } + if ((Test-PraOrdinalIgnoreCaseEqual $ActionName 'Check') -and -not (Test-PraOrdinalIgnoreCaseEqual $Expect 'Provisioned')) { $parts += "-Expect $Expect" } + if ($Once) { $parts += '-Once' } } # On another server the configuration file is that server's own: -ConfigPath is not repeated. # Run from the window, -ConfigPath is the generated configuration of that run: the suggested command names the configuration file itself. @@ -318,6 +337,78 @@ function Get-PraCommandLine { return ($parts -join ' ') } +function Get-PraFallbackNext { + <# + .SYNOPSIS + Next step of a run that ends in failure when no step set a more specific one: the command of this run as typed, and what the failed run kept. + #> + $isCheck = (Test-PraOrdinalIgnoreCaseEqual $Action 'Check') + $applied = (Test-PraOrdinalIgnoreCaseEqual $effectiveMode 'Apply') -and -not $isCheck + $modeName = if ($isCheck) { 'Preview' } else { $effectiveMode } + $typedBatch = if ($script:PackageArgument) { $script:PackageArgument } elseif ($Batch) { $Batch } else { '' } + $phaseName = if ($Phase -and -not $isCheck) { $Phase } else { '' } + $same = Get-PraCommandLine -ActionName $Action -PhaseName $phaseName -ModeName $modeName -BatchId $typedBatch -KeepFilters + $refusal = [string](Get-PraValue $context 'OptionRefusal' '') + if ($refusal) { + $selectors = [ordered]@{ Identity = [bool]$Identity; SearchBase = [bool]$SearchBase; CsvPath = [bool]$CsvPath; Group = [bool]$Group } + $given = @($selectors.Keys | Where-Object { $selectors[$_] }) + if ((Test-PraOrdinalEqual $refusal 'Selectors')) { + $steps = @(('These options select the objects in different ways and cannot be combined ({0}): keep one of them. Run the command with the one you want:' -f (($given | ForEach-Object { '-' + $_ }) -join ', '))) + foreach ($name in $given) { + $steps += ('Only -{0} (remove {1}):' -f $name, ((@($given | Where-Object { -not (Test-PraOrdinalEqual $_ $name) }) | ForEach-Object { '-' + $_ }) -join ', ')) + $steps += (Get-PraCommandLine -ActionName $Action -PhaseName $phaseName -ModeName $modeName -BatchId $typedBatch -KeepFilters -Only $name) + } + return $steps + } + $sourceNames = @($given | Where-Object { -not (Test-PraOrdinalEqual $_ 'Identity') } | ForEach-Object { '-' + $_ }) + $sources = $sourceNames -join ', ' + $selectWord = if ($sourceNames.Count -eq 1) { 'selects' } else { 'select' } + if ((Test-PraOrdinalEqual $refusal 'BatchWithSelectors')) { + return @('-Batch finishes a batch as a whole and takes none of -Identity, -SearchBase, -CsvPath and -Group. To finish that batch, give the batch alone:', + (Get-PraCommandLine -ActionName $Action -PhaseName $phaseName -ModeName $modeName -BatchId $typedBatch -KeepFilters -Only None), + ('To start a new conversion with {0}, remove -Batch:' -f $(if ($Identity) { '-Identity' } else { $sources })), + (Get-PraCommandLine -ActionName $Action -PhaseName $phaseName -ModeName $modeName -KeepFilters)) + } + $withoutSources = Get-PraCommandLine -ActionName $Action -PhaseName $(if ((Test-PraOrdinalIgnoreCaseEqual $Action 'Convert')) { $effectivePhase } else { $phaseName }) -ModeName $modeName -BatchId $typedBatch -KeepFilters -Only None + if ((Test-PraOrdinalIgnoreCaseEqual $Action 'Check') -and -not $typedBatch) { $withoutSources = $withoutSources -replace '^(\.\\Invoke-PraRemoteMailbox\.ps1 -Action Check)', "`$1 -Identity ''" } + $newConversion = Get-PraCommandLine -ActionName 'Convert' -PhaseName 'AD' -ModeName $modeName -KeepFilters + if ((Test-PraOrdinalIgnoreCaseEqual $Action 'Convert')) { + return @(('{0} only {1} the mailboxes of a new conversion, which is the AD phase (or Both) and takes no batch. Run it with -Phase AD:' -f $sources, $selectWord), $newConversion, + ('Or keep -Phase {0} and remove {1}:' -f $effectivePhase, $sources), $withoutSources) + } + return @(('{0} only {2} the mailboxes of a new Convert (-Phase AD or Both), not of {1}. To run {1}, remove {0}:' -f $sources, $Action, $selectWord), $withoutSources, + ('To convert the objects selected by {0} instead, run the AD phase of a new conversion:' -f $sources), $newConversion) + } + if ([bool](Get-PraValue $context 'Cancelled' $false)) { return @('Nothing was written. To run it, give the same command again and answer yes to the confirmation:', $same) } + if ([bool](Get-PraValue $context 'ConfirmationUnavailable' $false)) { return @('Nothing was written. This console cannot ask for the confirmation: add -Force to the command, or run it in an interactive console and answer yes:', ($same + ' -Force')) } + $newBatch = (Test-PraOrdinalIn $Action @('Convert', 'Recover') -IgnoreCase) -and (Test-PraOrdinalIn $effectivePhase @('AD', 'Both') -IgnoreCase) -and -not ((Test-PraOrdinalIgnoreCaseEqual $Action 'Convert') -and $Batch -and (Test-PraOrdinalIgnoreCaseEqual $effectivePhase 'AD')) + $written = @($context.Rows | Where-Object { (Get-PraValue $_ 'ADApplied' $false) -eq $true }).Count + if ([bool](Get-PraValue $context 'DcUnreachable' $false) -and $written -eq 0) { + $configFile = if ($context.Config -is [System.Collections.IDictionary] -and $context.Config.Contains('_Path')) { Split-Path ([string]$context.Config['_Path']) -Leaf } else { 'the configuration file' } + $server = [string]$context.Server + return @(('Nothing was changed. Active Directory did not answer on the domain controller {0}: check that it is running and reachable from this machine (TCP 9389), or set another one in DomainController of {1}. Then run the same command again:' -f $server, $configFile), $same, + ('Or run the same command on a machine that reaches {0}, or on the domain controller itself (the configuration file of that machine is used):' -f $server), + (Get-PraCommandLine -ActionName $Action -PhaseName $phaseName -ModeName $modeName -BatchId $typedBatch -KeepFilters -OtherServer)) + } + if ($applied -and $newBatch) { + $batchId = [string]$context.BatchId + if ($null -ne $context.Proof -and $batchId) { + $kept = 'What this run already did is kept (Active Directory is changed and verified).' + if ((Test-PraOrdinalIgnoreCaseEqual $Action 'Convert') -and (Test-PraOrdinalIgnoreCaseEqual $effectivePhase 'AD')) { + return @(('{0} Fix the problem named above, then finish the batch (Entra Connect sync and transfer package; AD is not changed again):' -f $kept), (Get-PraCommandLine -ActionName 'Convert' -PhaseName 'AD' -BatchId $batchId)) + } + return @(('{0} Fix the problem named above, then run the Exchange Online part:' -f $kept), (Get-PraCommandLine -ActionName $Action -PhaseName 'Cloud' -BatchId $batchId)) + } + if ($written -gt 0) { + return @(('Active Directory was changed for {0} object(s) before the stop (see the journal and the backup named above). Do not run the Apply again before reading what is left: run the Preview of the same command:' -f $written), + (Get-PraCommandLine -ActionName $Action -PhaseName $phaseName -ModeName 'Preview' -BatchId $typedBatch -KeepFilters)) + } + } + $didWork = $applied -and ([bool][string](Get-PraValue $context 'JournalPath' '') -or $written -gt 0) + if ($didWork) { return @('What this run already did is kept. Fix the problem named above, then run the same command again:', $same) } + return @('Fix the problem named above, then run the same command again:', $same) +} + function Get-PraBatchFile { <# .SYNOPSIS @@ -339,11 +430,22 @@ function Get-PraBatchFile { else { throw "Batch file or folder not found: $candidate" } } else { if ($Value -notmatch '^[0-9a-fA-F]{8,32}$') { throw "Invalid batch ID '$Value': use the 8 characters (or more) shown at the end of the previous run, or the path of the batch JSON file." } - if (-not (Test-Path -LiteralPath $context.BackupFolder -PathType Container)) { throw "Backup folder not found: $($context.BackupFolder)" } + if (-not (Test-Path -LiteralPath $context.BackupFolder -PathType Container)) { + $isCheck = (Test-PraOrdinalIgnoreCaseEqual $Action 'Check') + $packageSuffix = if ((Test-PraOrdinalIgnoreCaseEqual $Action 'Finalize')) { '-for-AD.zip' } else { '-for-Cloud.zip' } + $stepPhase = if ($Phase -and -not $isCheck) { $Phase } else { '' } + $stepMode = if ($isCheck) { 'Preview' } else { $effectiveMode } + $context.NextSteps = @('On the server that received a transfer package, give the package itself (copy the .zip file and its .sha256 file together into one folder; the batch is read from the package):', + (Get-PraCommandLine -ActionName $Action -PhaseName $stepPhase -ModeName $stepMode -BatchId ('\' + $packageSuffix) -KeepFilters), + ('Otherwise copy the batch folder (Batch-{0}... or Finalize-{0}...) into {1}, then run the same command again:' -f $Value, $context.BackupFolder), + (Get-PraCommandLine -ActionName $Action -PhaseName $stepPhase -ModeName $stepMode -BatchId $Value -KeepFilters)) + $context.NextOnFailure = $true + throw ("No batch is stored on this machine yet: the backup folder {0} does not exist, so batch {1} cannot be found here. Give the transfer package received from the other server, or copy the batch folder there." -f $context.BackupFolder, $Value) + } $folders = @(Get-ChildItem -LiteralPath $context.BackupFolder -Directory -Recurse -ErrorAction Stop | Where-Object { $_.Name -match ('^(Batch|Finalize)-' + [regex]::Escape($Value.ToLowerInvariant())) }) if (-not $folders.Count) { throw "Batch $Value not found under $($context.BackupFolder). Copy the batch folder there (Batch-$Value... or Finalize-$Value...) or give the path of its JSON file." } - if (@($folders | ForEach-Object Name | Get-PraOrdinalUnique).Count -gt 1) { throw "Batch ID $Value is ambiguous ($($folders.Count) folders): give more characters." } + if (@($folders | ForEach-Object Name | Get-PraOrdinalUnique -IgnoreCase).Count -gt 1) { throw "Batch ID $Value is ambiguous ($($folders.Count) folders): give more characters." } } $found = New-Object 'Collections.Generic.List[string]' foreach ($folder in $folders) { @@ -355,7 +457,7 @@ function Get-PraBatchFile { } # The same batch folder copied twice (identical content) is not an ambiguity. # (Group-Object would compare the hash texts with the culture comparison.) - $byHash = New-Object 'Collections.Generic.Dictionary[string,string]' -ArgumentList ([StringComparer]::Ordinal) + $byHash = New-Object 'Collections.Generic.Dictionary[string,string]' -ArgumentList ([StringComparer]::OrdinalIgnoreCase) foreach ($candidatePath in $found) { $candidateHash = Get-PraHash $candidatePath; if (-not $byHash.ContainsKey($candidateHash)) { $byHash[$candidateHash] = $candidatePath } } $distinct = @($byHash.Values) if ($distinct.Count -ne 1) { throw ("Batch {0}: expected one {1} file, found {2}. Check the batch ID (the batch of the previous step is expected)." -f $Value, ($Operations -join '/'), $distinct.Count) } @@ -370,7 +472,7 @@ function Find-PraConvertSource { #> param([Parameter(Mandatory)][string]$Hash) $found = @(Get-ChildItem -LiteralPath $context.BackupFolder -Recurse -File -Filter 'Convert-*.json.sha256' -ErrorAction Stop | Where-Object { - [string]::Equals(([IO.File]::ReadAllText($_.FullName).Trim()), $Hash, [StringComparison]::Ordinal) } | ForEach-Object { $_.FullName.Substring(0, $_.FullName.Length - 7) }) + [string]::Equals(([IO.File]::ReadAllText($_.FullName).Trim()), $Hash, [StringComparison]::OrdinalIgnoreCase) } | ForEach-Object { $_.FullName.Substring(0, $_.FullName.Length - 7) }) $original = @($found | Where-Object { (Split-Path (Split-Path $_ -Parent) -Leaf) -match '^Batch-' }) if ($original.Count) { $found = $original } if (-not $found.Count) { throw "The Convert batch used by this Recover is not in $($context.BackupFolder). Copy its Batch-... folder there as well." } @@ -482,15 +584,15 @@ function Get-PraFinalizeInput { $path = Get-PraBatchFile -Value $Batch -Operations @('RecoverFinalize') $context.CurrentOperation = 'Read-FinalizePackage' $manifest = Get-Content -LiteralPath $path -Raw -Encoding UTF8 -ErrorAction Stop | ConvertFrom-PraJson - if ((Get-PraValue $manifest 'SchemaVersion' 0) -ne 2 -or -not (Test-PraOrdinalEqual $manifest.Operation 'RecoverFinalize') -or -not (Test-PraOrdinalEqual $manifest.Environment $context.Config.Environment)) { throw 'Finalize package of another version or Environment: nothing restored.' } - if (-not (Test-PraOrdinalEqual (Get-Content -LiteralPath ($path + '.sha256') -Raw -ErrorAction Stop).Trim() (Get-PraHash $path))) { throw 'Finalize package: SHA-256 mismatch.' } + if ((Get-PraValue $manifest 'SchemaVersion' 0) -ne 2 -or -not (Test-PraOrdinalEqual $manifest.Operation 'RecoverFinalize') -or -not (Test-PraOrdinalIgnoreCaseEqual $manifest.Environment $context.Config.Environment)) { throw 'Finalize package of another version or Environment: nothing restored.' } + if (-not (Test-PraOrdinalIgnoreCaseEqual (Get-Content -LiteralPath ($path + '.sha256') -Raw -ErrorAction Stop).Trim() (Get-PraHash $path))) { throw 'Finalize package: SHA-256 mismatch.' } foreach ($property in @('SourceBackupFile','StateFile')) { if (-not (Test-PraOrdinalEqual ([IO.Path]::GetFileName($manifest.$property)) $manifest.$property)) { throw 'Finalize package: a file path points outside the package.' } } $context.Source = Import-PraBackup $context (Join-Path (Split-Path $path -Parent) $manifest.SourceBackupFile) $context.PhaseFolders = @(Split-Path $path -Parent) $context.Proof = Import-PraProof $context (Join-Path (Split-Path $path -Parent) $manifest.StateFile) $context.Source 'Recover' - if (-not (Test-PraOrdinalEqual $context.Source.Hash $manifest.SourceBackupHash) -or -not (Test-PraOrdinalEqual $context.Proof.Hash $manifest.StateHash)) { throw 'Finalize package: manifest and proofs do not match.' } + if (-not (Test-PraOrdinalIgnoreCaseEqual $context.Source.Hash $manifest.SourceBackupHash) -or -not (Test-PraOrdinalIgnoreCaseEqual $context.Proof.Hash $manifest.StateHash)) { throw 'Finalize package: manifest and proofs do not match.' } $records = @(Select-PraSourceRecord $context.Source); $seen = @{} $items = @($manifest.Items) if (-not $items.Count) { throw 'Finalize package is empty.' } @@ -548,7 +650,7 @@ function Publish-PraTransferPackage { -OutboxFolder (Join-Path $context.BackupFolder 'Outbox') -NextCommand $command -ToolVersion $context.Version $context.TransferPackage = $package.Path; $context.TransferPackageKind = $Kind Write-PraItem -Context $context -Status Ok -Icon Batch -Text ('Transfer package {0} written ({1}, checksums verified)' -f $package.Name, (Format-PraByteSize $package.SizeBytes)) -Detail $package.Path - $context.NextSteps = @(('Copy {0} to the {1} server (anywhere), then run there:' -f $package.Path, $targetName), $command) + $context.NextSteps = @(('Copy these two files, together in the same folder, to the {0} server (anywhere): {1} and {2}. Then run there:' -f $targetName, $package.Path, $package.Sidecar), $command) } catch { Write-PraLog -Context $context -Message ('The transfer package could not be created ({0}). The folders are complete: copy them by hand as indicated below.' -f $_.Exception.Message) -Level Warning @@ -589,8 +691,12 @@ function Test-PraSyncAvailable { return } $message = 'Entra Connect sync will not be possible: {0}. Either fix that, or set EntraConnect.Sync = $false in the configuration file and run the synchronisation yourself after the AD changes.' -f $answer.Reason - if ($context.AllowMutation) { throw ('{0} Nothing was changed.' -f $message) } + Write-PraLog -Context $context -Message ('Entra Connect check, technical message: {0}' -f $answer.Technical) -Level Detail + # Refused before any change: the run reports no object (none was touched) and no global report, and the error names the run, not the last object looked at. + if ($context.AllowMutation) { $context.NoChangeMade = $true; $context.CurrentIdentity = ''; throw ('{0} Nothing was changed.' -f $message) } Write-PraItem -Context $context -Status Warn -Icon Sync -Text $message -Detail $answer.Technical + $fix = if ((Test-PraOrdinalEqual $answer.Kind 'Denied')) { 'give this account the rights named in the warning above' } else { 'fix the problem named in the warning above' } + $context.ApplyBlockers = @(Get-PraList $context 'ApplyBlockers') + ('{0}, or set EntraConnect.Sync = $false in the configuration file and run the Entra Connect sync yourself after the AD changes' -f $fix) } function Test-PraCloudModuleAvailable { @@ -609,8 +715,9 @@ function Test-PraCloudModuleAvailable { } $text = $report.Messages -join ' ' $signsIn = $context.AllowMutation -or (Test-PraOrdinalIgnoreCaseEqual $Action 'Check') -or (Test-PraOrdinalIgnoreCaseEqual $effectivePhase 'Cloud') - if ($signsIn) { throw ('The cloud part cannot run on this server. {0} Nothing was changed.' -f $text) } + if ($signsIn) { $context.NoChangeMade = $true; $context.CurrentIdentity = ''; throw ('The cloud part cannot run on this server. {0} Nothing was changed.' -f $text) } Write-PraItem -Context $context -Status Warn -Icon Cloud -Text ('The cloud part will not be possible on this server. {0}' -f $text) + $context.ApplyBlockers = @(Get-PraList $context 'ApplyBlockers') + 'install or update the cloud modules with the commands in the warning above' } function Confirm-PraApply { @@ -625,9 +732,11 @@ function Confirm-PraApply { Write-Host '' $answer = $false try { $answer = $caller.ShouldContinue($Question, 'PRA Remote Mailbox - Apply') } - catch { throw "Apply needs a confirmation and this console cannot ask for one ($($_.Exception.Message)). Run it in an interactive console or add -Force." } + catch { $context.ConfirmationUnavailable = $true; $context.NoChangeMade = $true; throw "Apply needs a confirmation and this console cannot ask for one ($($_.Exception.Message)). Run it in an interactive console or add -Force." } if (-not $answer) { $context.AllowMutation = $false + $context.Cancelled = $true + $context.NoChangeMade = $true throw 'Cancelled by the operator: nothing was written.' } $script:ConfirmPreference = 'None' @@ -679,13 +788,20 @@ function Get-PraSkipReason { # ================================================================================================= $script:ConfigPathBound = $PSBoundParameters.ContainsKey('ConfigPath') $script:PreviewPackage = '' +$script:PackageArgument = '' +$script:ImportedFolders = @() $script:ConfirmBound = $PSBoundParameters.ContainsKey('Confirm') +# Known from the start; the run sets it from the configuration. +$effectivePhase = [string]$Phase try { # --------------------------------------------------------------------------------------------- # Configuration, audit files, banner. # --------------------------------------------------------------------------------------------- $context.CurrentOperation = 'Read-Configuration' - $targetOverride = Get-PraTargetOverride -SearchBase $SearchBase -CsvPath $CsvPath -Identity $Identity + # Object selectors that cannot be combined: the refusal below comes with the corrected commands (Get-PraFallbackNext). + $selectorCount = @(@($SearchBase, $CsvPath, $Group) | Where-Object { $_ }).Count + if (($selectorCount -gt 1 -or ($Identity -and $selectorCount)) -and -not @(@($SearchBase, $CsvPath, $Group) | Where-Object { $_ -match '[\x00-\x1f]' }).Count) { $context.OptionRefusal = 'Selectors' } + $targetOverride = Get-PraTargetOverride -SearchBase $SearchBase -CsvPath $CsvPath -Identity $Identity -Group $Group $context.Config = Import-PraConfiguration -Path $ConfigPath -Root $PSScriptRoot -ScopeOverride $targetOverride -DeferScopeCheck $config = $context.Config $context.BackupFolder = $config.Storage.BackupFolder @@ -716,8 +832,10 @@ try { default { if ($Phase) { $Phase } else { $config.Execution.Phase } } } $context.Phase = $effectivePhase - if (($SearchBase -or $CsvPath) -and ((-not (Test-PraOrdinalIgnoreCaseEqual $Action 'Convert')) -or (-not (Test-PraOrdinalIn $effectivePhase @('AD','Both') -IgnoreCase)))) { - throw 'SearchBase/CsvPath are only available for Convert -Phase AD or Both.' + $context.CurrentOperation = 'Check-Options' + if (($SearchBase -or $CsvPath -or $Group) -and ((-not (Test-PraOrdinalIgnoreCaseEqual $Action 'Convert')) -or (-not (Test-PraOrdinalIn $effectivePhase @('AD','Both') -IgnoreCase)))) { + $context.OptionRefusal = 'SelectorsNotAvailable' + throw 'SearchBase/CsvPath/Group are only available for Convert -Phase AD or Both.' } # Only a new conversion (Convert, phase AD or Both, no batch, no single account) needs to know which mailboxes to take: Check, the cloud phases, Recover and Finalize never ask for the scope. @@ -781,13 +899,14 @@ try { foreach ($announcedStep in @($steps)) { $planIndex++; $planSteps += [ordered]@{ id = ('s' + $planIndex); label = [string]$announcedStep; count = $null } } Write-PraEvent -Kind plan -Data @{ steps = $planSteps } + $context.CurrentOperation = 'Check-Options' foreach ($forbidden in $config.Storage.ForbiddenBackupRoots) { if ($context.AllowMutation -and ($context.BackupFolder.TrimEnd('\') + '\').StartsWith($forbidden, [StringComparison]::OrdinalIgnoreCase)) { throw "Backup folder on a forbidden volume (Storage.ForbiddenBackupRoots): $forbidden" } } if ($Batch -and (Test-PraOrdinalIgnoreCaseEqual $Action 'Convert') -and (-not (Test-PraOrdinalIgnoreCaseEqual $effectivePhase 'Cloud'))) { # -Phase AD -Batch finishes a batch already converted (synchronisation and transfer package); a new conversion takes its targets from the configuration. if (-not (Test-PraOrdinalIgnoreCaseEqual $effectivePhase 'AD')) { throw '-Batch is not used by Convert -Phase Both: the targets come from the configuration (or -Identity). To finish the AD side of a batch already converted, use -Phase AD -Batch ; for its Exchange Online part, -Phase Cloud -Batch .' } - if ($Identity -or $SearchBase -or $CsvPath) { throw '-Phase AD with -Batch finishes a batch as a whole: -Identity, -SearchBase and -CsvPath cannot be combined with it.' } + if ($Identity -or $SearchBase -or $CsvPath -or $Group) { $context.OptionRefusal = 'BatchWithSelectors'; throw '-Phase AD with -Batch finishes a batch as a whole: -Identity, -SearchBase, -CsvPath and -Group cannot be combined with it.' } } if (-not $Batch -and ((Test-PraOrdinalIn $Action @('Recover','Finalize') -IgnoreCase) -or ((Test-PraOrdinalIgnoreCaseEqual $Action 'Convert') -and (Test-PraOrdinalIgnoreCaseEqual $effectivePhase 'Cloud')))) { throw ("-Batch is required for {0}{1}: give the batch ID printed at the end of the previous step." -f $Action, $(if ((Test-PraOrdinalIgnoreCaseEqual $effectivePhase 'Cloud')) { ' -Phase Cloud' } else { '' })) @@ -797,6 +916,7 @@ try { # A transfer package from the other server: verified completely, then extracted to private folders; -Batch becomes the batch it carries and every # existing proof and hash check runs unchanged on the extracted folders. $context.CurrentOperation = 'Import-TransferPackage' + $script:PackageArgument = [string]$Batch $packagePath = Resolve-PraTransferPackagePath $Batch $expectedKind = switch ($Action) { 'Recover' { if ((Test-PraOrdinalIgnoreCaseEqual $effectivePhase 'Cloud')) { 'Recover' } else { 'Convert' } } 'Finalize' { 'Finalize' } default { 'Convert' } } $importRoot = $context.BackupFolder @@ -810,6 +930,7 @@ try { $imported = Import-PraTransferPackage -Path $packagePath -BackupFolder $importRoot -Environment $config.Environment -ExpectedKind $expectedKind Write-PraItem -Context $context -Status Ok -Icon Batch -Text ('Transfer package {0} verified (checksums, Environment, names): {1} folder(s) extracted, {2} already present and identical' -f $imported.Name, $imported.Created.Count, $imported.Existing.Count) if ((-not (Test-PraOrdinalIgnoreCaseEqual $effectiveMode 'Apply'))) { Write-PraItem -Context $context -Status Info -Text 'Preview: the package was verified and read from a private temporary folder, deleted at the end. Nothing was written to the backup folder.' } + $script:ImportedFolders = @($imported.Created) $Batch = [string]$imported.BatchId if ($PSBoundParameters.ContainsKey('Batch')) { $PSBoundParameters['Batch'] = $Batch } } @@ -869,6 +990,8 @@ try { $context.Proof = Import-PraProof $context $proofPath $context.Source 'Convert' $context.BatchId = Get-PraShortId ([string]$context.Source.Data.BatchId) $context.PhaseFolders = @($batchFolder) + # The preflight runs before any object is marked: a refused run has touched nothing and must not show objects as done. + Test-PraSyncAvailable foreach ($record in @($context.Source.Data.Records)) { if (@($context.Proof.Data.Records | Where-Object { Test-PraOrdinalIgnoreCaseEqual $_.ObjectGuid $record.ObjectGuid }).Count -ne 1) { throw "Object not verified by the AD phase of this batch: $($record.SamAccountName). The batch cannot be finished from here. Nothing was changed." } $row = New-PraRow $context $record @@ -883,7 +1006,6 @@ try { } Send-PraPlanCount $context.Rows.Count Write-PraItem -Context $context -Status Ok -Text ("Batch {0}: {1} object(s), AD changes already made and verified (they are not changed again), backup and proof checked" -f $context.BatchId, $context.Rows.Count) - Test-PraSyncAvailable if ($context.AllowMutation) { Confirm-PraApply ("Finish batch {0}? {1}A transfer package is written. AD is not changed again." -f $context.BatchId, $(if ($config.EntraConnect.Sync) { 'Entra Connect synchronises first. ' } else { '' })) $context.PhaseWriteFolder = $batchFolder @@ -906,7 +1028,7 @@ try { Initialize-PraDirectory $context -ValidateScope Write-PraStep -Context $context -Title 'Targets and planned changes' -Icon Plan $targets = @(Get-PraTarget $context $Identity $Scope $MaxObjects) - if (-not $targets.Count) { Write-PraItem -Context $context -Status Warn -Text 'No on-premises mailbox found in the scope: nothing to convert.' } + if (-not $targets.Count -and -not [bool](Get-PraValue $context 'TargetsReported' $false)) { Write-PraItem -Context $context -Status Warn -Text 'No on-premises mailbox found in the scope: nothing to convert.' } $plans = @(foreach ($target in $targets) { New-PraPlan $context ([string]$target.ObjectGUID) 'Convert' }) Send-PraPlanCount $plans.Count if ($plans.Count) { @@ -921,7 +1043,7 @@ try { } if ((Test-PraOrdinalIgnoreCaseEqual $effectivePhase 'Both')) { if ($context.AllowMutation -and $plans.Count) { - # Sign-in and identities are checked BEFORE the first AD write. + # Sign-in and identities are checked before the first AD write. Write-PraStep -Context $context -Title 'Exchange Online pre-check' -Icon Cloud $context.CurrentOperation = 'CloudPreflightBeforeAD' Import-Module (Join-Path $PSScriptRoot 'module\PRA.Cloud.psm1') -Force -ErrorAction Stop @@ -952,7 +1074,7 @@ try { else { if ($replicate) { Skip-PraStep -Title 'Active Directory replication' -Reason (Get-PraSkipReason $plans.Count) -Icon Directory } Skip-PraStep -Title 'Entra Connect synchronisation' -Reason (Get-PraSkipReason $plans.Count) - if ($plans.Count) { $context.NextSteps = @(Get-PraCommandLine -ActionName 'Convert' -PhaseName $(if ($Phase) { $Phase } else { '' }) -KeepFilters) } + if ($plans.Count) { $context.NextSteps = @(Get-PraCommandLine -ActionName 'Convert' -PhaseName $(if ($Phase) { $Phase } else { '' }) -KeepFilters) + @(Get-PraList $context 'ContinueSteps') } } } # --------------------------------------------------------------------------------------------- @@ -985,8 +1107,8 @@ try { } if ((Test-PraOrdinalIgnoreCaseEqual $effectivePhase 'Both')) { if ($context.AllowMutation -and $plans.Count) { - # Same guarantee as Convert: the Exchange Online sign-in, tenant and targets are checked (read only) - # BEFORE the first AD write, so a cloud problem does not leave AD restored and the cloud part undone. + # The Exchange Online sign-in, tenant and targets are checked (read only) before the first AD write: + # a cloud problem cannot leave AD restored and the cloud part undone. Write-PraStep -Context $context -Title 'Exchange Online pre-check' -Icon Cloud $context.CurrentOperation = 'CloudPreflightBeforeAD' Import-Module (Join-Path $PSScriptRoot 'module\PRA.Cloud.psm1') -Force -ErrorAction Stop @@ -1110,9 +1232,68 @@ try { Import-Module (Join-Path $PSScriptRoot 'module\PRA.Cloud.psm1') -Force -ErrorAction Stop if ((Test-PraOrdinalIgnoreCaseEqual $Action 'Check') -and (Test-PraOrdinalIgnoreCaseEqual $Expect 'Retained')) { Invoke-PraRetentionCheck -Context $context -Rows $context.Rows.ToArray() } else { Invoke-PraCloudPhase -Context $context -Rows $context.Rows.ToArray() -Act $cloudAction } - if ($context.Issues.Count -or @($context.Rows | Where-Object { Test-PraOrdinalEqual $_.CloudStatus 'Error' }).Count) { throw 'Exchange Online check failed: no restore or clean-up is done.' } + $cloudErrors = @($context.Rows | Where-Object { Test-PraOrdinalEqual $_.CloudStatus 'Error' }) + $runErrors = @($cloudErrors | Where-Object { [bool](Get-PraValue $_ 'RunError' $false) }).Count + $notExpected = $cloudErrors.Count - $runErrors + if ((Test-PraOrdinalIgnoreCaseEqual $Action 'Check') -and $notExpected -and -not $runErrors -and -not $context.CloudConnectFailed) { + Write-PraItem -Context $context -Status Fail -Text ('Check finished: {0} object(s) not in the expected state. Nothing was changed.' -f $notExpected) + $context.CheckFinished = $true + $context.NextSteps = @('If the Entra Connect sync has not run since the Active Directory changes, run it first (Start-ADSyncSyncCycle -PolicyType Delta on the Entra Connect server, or wait for the next automatic cycle, about 30 minutes), then run the Check again:', + (Get-PraCommandLine -ActionName 'Check' -ModeName 'Preview' -BatchId $(if ($script:PreviewPackage) { $script:PreviewPackage } else { $Batch }) -KeepFilters)) + $context.NextOnFailure = $true + } + elseif ($context.Issues.Count -or $cloudErrors.Count) { + $isCheck = (Test-PraOrdinalIgnoreCaseEqual $Action 'Check') + $network = [bool](Get-PraValue $context 'NetworkFailure' $false) + # The stop names the first object whose check failed. + if (-not [int](Get-PraValue $context 'CloudNotReached' 0) -and -not (Test-PraOrdinalIn ([string]$context.CurrentOperation) @('Connect-MgGraph', 'Connect-ExchangeOnline'))) { + $failedIssues = @($context.Issues.ToArray() | Where-Object { Test-PraOrdinalEqual ([string](Get-PraValue $_ 'Source' '')) 'Cloud' }) + if ($failedIssues.Count) { + $context.CurrentOperation = [string](Get-PraValue $failedIssues[0] 'Operation' $context.CurrentOperation) + $context.CurrentIdentity = [string](Get-PraValue $failedIssues[0] 'Identity' '') + } + } + $lead = if ($network) { 'Microsoft 365 did not answer' } elseif ($isCheck) { 'The Exchange Online check could not be done' } else { 'Exchange Online check failed' } + if (-not $context.AllowMutation) { + $again = if ($isCheck) { 'Check' } else { 'Preview' } + $stop = '{0}. Nothing was changed. Run the {1} again.' -f $lead, $again + $rerun = Get-PraCommandLine -ActionName $Action -PhaseName $(if ($isCheck) { '' } else { $effectivePhase }) -ModeName 'Preview' -BatchId $(if ($script:PreviewPackage) { $script:PreviewPackage } else { $Batch }) -KeepFilters + $first = if ($network) { 'Microsoft 365 did not answer from this machine. Nothing was changed: run the {0} again when the connection works:' -f $again } else { 'Nothing was changed. Fix the problem named above, then run the {0} again:' -f $again } + $context.NextSteps = @($first, $rerun) + $context.NextOnFailure = $true + throw $stop + } + $bothContinues = $false + # The command is given as the operator typed it: the package path or the batch ID. + $typedBatch = if ($script:PackageArgument) { $script:PackageArgument } elseif ($Batch) { $Batch } else { $context.BatchId } + if ($network -and (Test-PraOrdinalIgnoreCaseEqual $effectivePhase 'Cloud')) { + $context.NextSteps = @('Microsoft 365 did not answer from this machine. What this run already did is kept: run the same command again when the connection works:', (Get-PraCommandLine -ActionName $Action -PhaseName 'Cloud' -BatchId $typedBatch -KeepFilters)) + $context.NextOnFailure = $true + } + elseif ((Test-PraOrdinalIgnoreCaseEqual $effectivePhase 'Cloud')) { + # The objects did not reach the expected state in time: the Entra Connect sync is the usual reason. The cloud phase is meant to be run again. + $waited = [int](Get-PraValue $context 'CloudNotReached' 0) -gt 0 + $cloudSteps = @() + if ($waited) { + $cloudSteps += 'If the Entra Connect sync has not run since the Active Directory changes, run it first (Start-ADSyncSyncCycle -PolicyType Delta on the Entra Connect server, or wait for the next automatic cycle, about 30 minutes).' + $cloudSteps += 'What this run already did is kept: run the same command again:' + } + else { $cloudSteps += 'What this run already did is kept. Fix the problem named above, then run the same command again:' } + $cloudSteps += Get-PraCommandLine -ActionName $Action -PhaseName 'Cloud' -BatchId $typedBatch -KeepFilters + $context.NextSteps = $cloudSteps + $context.NextOnFailure = $true + } + elseif ((Test-PraOrdinalIgnoreCaseEqual $effectivePhase 'Both') -and $context.BatchId -and $null -ne $context.Proof) { + # The Active Directory part of the batch is written and verified (Convert or Recover): only the Exchange Online part is left, and the batch is continued by its ID. + $bothContinues = $true + $bothFirst = if ($network) { 'Microsoft 365 did not answer from this machine. What this run already did is kept (Active Directory is changed and verified): run the Exchange Online part when the connection works:' } else { 'What this run already did is kept (Active Directory is changed and verified). Fix the problem named above, then run the Exchange Online part:' } + $context.NextSteps = @($bothFirst, (Get-PraCommandLine -ActionName $Action -PhaseName 'Cloud' -BatchId $context.BatchId)) + $context.NextOnFailure = $true + } + throw $(if ($bothContinues) { '{0}: the cloud part of this batch is not complete; Active Directory is done, see the next steps.' -f $lead } elseif ((Test-PraOrdinalIgnoreCaseEqual $Action 'Recover')) { '{0}: the cloud part of this batch is not complete, so the final restore and clean-up are not done; run it again with the same command.' -f $lead } else { '{0}: the cloud part of this batch is not complete; run it again with the same command.' -f $lead }) + } - # Recover: shared mailboxes (deprovisioned in the cloud) and retention tags are restored only now. + # Recover: shared mailboxes (deprovisioned in the cloud) and retention tags are restored after the cloud checks. if ((Test-PraOrdinalIgnoreCaseEqual $Action 'Recover')) { Write-PraStep -Context $context -Title 'Final restore of shared mailboxes and tags' -Icon Write if ($context.AllowMutation) { @@ -1148,6 +1329,11 @@ try { } if (-not $context.AllowMutation -and (Test-PraOrdinalIn $Action @('Convert','Recover') -IgnoreCase) -and -not $context.NextSteps.Count) { $context.NextSteps = @(Get-PraCommandLine -ActionName $Action -PhaseName 'Cloud' -BatchId $(if ($script:PreviewPackage) { $script:PreviewPackage } else { $Batch }) -KeepFilters) + # Objects not yet in the expected state: the Entra Connect sync is the usual reason, so it comes first. + $notYet = [int](Get-PraValue $context 'NotYetExpected' 0) + if ($notYet -gt 0) { + $context.NextSteps = @(('{0} object(s) are not yet in the expected state in Exchange Online. If the Entra Connect sync has not run since the Active Directory changes, run it first (Start-ADSyncSyncCycle -PolicyType Delta on the Entra Connect server, or wait for the next automatic cycle, about 30 minutes), then run this Preview again.' -f $notYet), 'When the objects are ready, run the Apply:') + @($context.NextSteps) + } } } elseif ($runCloud) { Write-PraItem -Context $context -Status Warn -Text 'No object to check in Exchange Online.' } @@ -1156,18 +1342,24 @@ try { $syncFailure = Get-PraValue $context 'SyncFailure' $null $announced = @($steps) for ($i = [int]$context.StepIndex; $i -lt $announced.Count; $i++) { - $skipReason = if ($null -ne $syncFailure) { 'Not run: the Entra Connect synchronisation could not start (see the next steps).' } else { Get-PraSkipReason ($context.Rows.Count -gt 0) } + $skipReason = if ($null -ne $syncFailure) { 'Not run: the Entra Connect sync cycle could not run (see the next steps).' } else { Get-PraSkipReason ($context.Rows.Count -gt 0) } Skip-PraStep -Title $announced[$i] -Reason $skipReason } if ($context.AllowMutation -and (Test-PraOrdinalIgnoreCaseEqual $Action 'Convert') -and (Test-PraOrdinalIn $effectivePhase @('Both','Cloud') -IgnoreCase) -and $context.BatchId -and -not $context.Issues.Count -and $null -eq $syncFailure) { - $context.NextSteps = @($(if ((Test-PraOrdinalIgnoreCaseEqual $effectivePhase 'Cloud')) { 'To roll back this batch later, on the AD server: ' + (Get-PraCommandLine -ActionName 'Recover' -ModeName 'Preview' -BatchId $context.BatchId -OtherServer) } else { 'To roll back this batch later: ' + (Get-PraCommandLine -ActionName 'Recover' -ModeName 'Preview' -BatchId $context.BatchId) })) + $context.NextSteps = @($(if ((Test-PraOrdinalIgnoreCaseEqual $effectivePhase 'Cloud')) { 'To roll back this batch later, on the AD server (Preview first, then the same command with -Mode Apply): ' + (Get-PraCommandLine -ActionName 'Recover' -PhaseName 'AD' -ModeName 'Preview' -BatchId $context.BatchId -OtherServer) } else { 'To roll back this batch later: ' + (Get-PraCommandLine -ActionName 'Recover' -ModeName 'Preview' -BatchId $context.BatchId) })) + } + + # A Preview that already knows that the Apply will be refused says what to fix before it proposes the Apply. + $applyBlockers = @(Get-PraList $context 'ApplyBlockers') + if (-not $context.AllowMutation -and $applyBlockers.Count -and @(Get-PraList $context 'NextSteps').Count) { + $context.NextSteps = @($applyBlockers | ForEach-Object { 'The Apply would be refused as things stand. First {0}.' -f $_ }) + @('Then run the Apply:') + @(Get-PraList $context 'NextSteps') } # The synchronisation could not run after the AD changes were verified: say plainly what is done and what to do (the transfer package, when there is one, follows). if ($null -ne $syncFailure) { $syncLines = @( - ('AD is changed and verified. The Entra Connect sync could not start: {0}.' -f $syncFailure.Reason), + ('AD is changed and verified. The Entra Connect sync did not run: {0}.' -f $syncFailure.Reason), ('Run a delta sync on {0} (Start-ADSyncSyncCycle -PolicyType Delta) or wait for the next automatic cycle (about 30 minutes).' -f $syncFailure.Server)) if ((Test-PraOrdinalIn $Action @('Convert','Recover') -IgnoreCase) -and (Test-PraOrdinalIgnoreCaseEqual $effectivePhase 'Both') -and $context.BatchId) { $syncLines += ('Then continue this batch from here (it waits for the Exchange Online part to be ready): ' + (Get-PraCommandLine -ActionName $Action -PhaseName 'Cloud' -BatchId $context.BatchId)) @@ -1197,12 +1389,45 @@ catch { try { # The error may already be recorded by the module that raised it: then log the stop only. $known = @($context.Issues.ToArray() | Where-Object { ([string](Get-PraValue $_ 'Message' '')).Contains($failure.Exception.Message) }).Count -gt 0 - $stopMessage = "Stopped at step '{0}' (operation {1}{2}): {3}" -f $context.CurrentPhase, $context.CurrentOperation, $(if ($context.CurrentIdentity) { ', object ' + $context.CurrentIdentity } else { '' }), $failure.Exception.Message - Write-PraLog -Context $context -Message $stopMessage -Level $(if ($known) { 'Detail' } else { 'Error' }) + # The object is named by its UPN when the identity is the GUID of a row of the run. + $stopObject = [string]$context.CurrentIdentity + $stopRow = @($context.Rows | Where-Object { $stopObject -and (Test-PraOrdinalIgnoreCaseEqual ([string](Get-PraValue $_ 'ObjectGuid' '')) $stopObject) -and [string](Get-PraValue $_ 'UserPrincipalName' '') } | Select-Object -First 1) + if ($stopRow.Count) { $stopObject = [string](Get-PraValue $stopRow[0] 'UserPrincipalName' '') } + # A failure to connect concerns the service for every object: the stop names the service, not the last object of the list. + $stopService = if (Test-PraOrdinalEqual ([string]$context.CurrentOperation) 'Connect-MgGraph') { 'Microsoft Graph' } elseif (Test-PraOrdinalEqual ([string]$context.CurrentOperation) 'Connect-ExchangeOnline') { 'Exchange Online' } else { '' } + # Objects that did not reach the expected state in time are a failure of the whole list: the stop names their number, not the last object looked at. + $stopCount = if (-not $stopService -and (Test-PraOrdinalEqual ([string]$context.CurrentOperation) 'CloudCheck') -and [int](Get-PraValue $context 'CloudNotReached' 0) -gt 0) { @($context.Rows | Where-Object { Test-PraOrdinalEqual ([string](Get-PraValue $_ 'CloudStatus' '')) 'Error' }).Count } else { 0 } + $stopMessage = "Stopped at step '{0}' (operation {1}{2}): {3}" -f $context.CurrentPhase, $context.CurrentOperation, $(if ($stopService) { ', service ' + $stopService } elseif ($stopCount) { ', {0} object(s)' -f $stopCount } elseif ($stopObject) { ', object ' + $stopObject } else { '' }), $failure.Exception.Message + Write-PraLog -Context $context -Message $stopMessage -Level $(if ($known -or [bool](Get-PraValue $context 'Cancelled' $false)) { 'Detail' } else { 'Error' }) Write-PraLog -Context $context -Message ("ErrorId={0} | {1} | {2}" -f $failure.FullyQualifiedErrorId, $failure.InvocationInfo.PositionMessage, $failure.ScriptStackTrace) -Level Debug } catch { $context.Issues.Add([pscustomobject]@{ Message = $failure.Exception.Message; Source = 'Execution' }) } $context.ExitCode = 1 + # The domain controller refused the account before the first write: the summary says what is left on this server and how to run the step correctly. + $notAppliedFolder = [string](Get-PraValue $context 'NotAppliedFolder' '') + if ($notAppliedFolder) { + try { + $notAppliedSteps = @(('Nothing was written to Active Directory. The backup folder {0} is marked NOT-APPLIED: you can delete it, or keep it as evidence. It is not a batch to continue or to roll back.' -f $notAppliedFolder)) + if (@($script:ImportedFolders).Count) { $notAppliedSteps += ('The package was extracted to {0}: keep it for the next run, or delete it.' -f (@($script:ImportedFolders) -join ', ')) } + if ($CsvPath -and -not $Batch) { $notAppliedSteps += ('Copy the file {0} (the -CsvPath of this run) to the domain controller {1}, to the folder where you run the command.' -f [IO.Path]::GetFileName($CsvPath), $context.Server) } + $notAppliedSteps += ('Run the step again on the domain controller {0}, or with an account that has the right to write there (see Prerequisites). Run the Preview first, then the same command with -Mode Apply:' -f $context.Server) + # The batch is named by its ID: the package is a file of this server, the batch exists on the AD server that wrote it; that server has its own configuration file. + $otherBatch = if ($script:PackageArgument) { $script:PackageArgument } else { $Batch } + try { $sourceId = [string](Get-PraValue (Get-PraValue (Get-PraValue $context 'Source' $null) 'Data' $null) 'BatchId' ''); if ($sourceId) { $otherBatch = Get-PraShortId $sourceId } } catch { $null = $_ } + $notAppliedSteps += (Get-PraCommandLine -ActionName $Action -PhaseName $(if ($Phase) { $Phase } else { '' }) -ModeName 'Preview' -BatchId $otherBatch -KeepFilters -OtherServer) + $context.NextSteps = $notAppliedSteps + } + catch { $null = $_ } + } + # A Check that cannot reach the domain controller changed nothing: it says how to run it again. + if ((Get-PraValue $context 'DcUnreachable' $false) -and (Test-PraOrdinalIgnoreCaseEqual $Action 'Check')) { + try { + $context.NextSteps = @('Nothing was changed. Run the Check again from a machine that reaches the domain controller:', (Get-PraCommandLine -ActionName 'Check' -ModeName 'Preview' -KeepFilters -OtherServer), + 'Or give the UPN of the mailbox instead of the account name (no Active Directory read is needed):', ((Get-PraCommandLine -ActionName 'Check' -ModeName 'Preview' -KeepFilters) -replace "-Identity '[^']*'", "-Identity ''")) + $context.NextOnFailure = $true + } + catch { $null = $_ } + } } finally { Initialize-PraPermissionCache -Context $context @@ -1216,16 +1441,19 @@ finally { if (Get-Command Close-PraCloudSession -ErrorAction SilentlyContinue) { try { Close-PraCloudSession -Context $context } catch { $context.Issues.Add([pscustomobject]@{ Message = "Cloud sign-out: $($_.Exception.Message)"; Source = 'Cloud' }) } } + # What a failed run proposes when no step set a more specific next step. + try { $context.FallbackNext = @(Get-PraFallbackNext) } + catch { $context.FallbackNext = @('Fix the problem named above, then run the same command again with the same options.') } $result = Complete-PraRun -Context $context if ($PassThru) { $result } exit $result.ExitCode } # SIG # Begin signature block -# MIImKwYJKoZIhvcNAQcCoIImHDCCJhgCAQExDzANBglghkgBZQMEAgEFADB5Bgor +# MIImKgYJKoZIhvcNAQcCoIImGzCCJhcCAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG -# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCl7PKR8vqWmCTH -# Qc+e/OTi5hIqOUuoON9lpDx82WoFXaCCDW8wggZyMIIEWqADAgECAghkM1HTxzif +# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAupjDsezx0P6kX +# uRHzsYPusl7YRilGPEM4yTpTuRMAA6CCDW8wggZyMIIEWqADAgECAghkM1HTxzif # CDANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMx # EDAOBgNVBAcMB0hvdXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8G # A1UEAwwoU1NMLmNvbSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IFJTQTAe @@ -1297,28 +1525,28 @@ finally { # ULeH38N0Vr83psiJVuBSxQyt5nRVrpYz7FACq5gtXELkyViq/rGOlJKaRrgQ6WWq # eoIXqKhVFAdP/jAEm2M8ezoVYsUgPyKY2OcuecV9coulAcxUIUydx6qYiOfsGj5u # Dy7l4aYjvB771wkUMzUQwxzcDYXJtMMTaWRe6n9EemR67jc73u5CJyFg3PfA5WR1 -# wZislcdCZuS6MYIYEjCCGA4CAQEwgYwweDELMAkGA1UEBhMCVVMxDjAMBgNVBAgM +# wZislcdCZuS6MYIYETCCGA0CAQEwgYwweDELMAkGA1UEBhMCVVMxDjAMBgNVBAgM # BVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMREwDwYDVQQKDAhTU0wgQ29ycDE0MDIG # A1UEAwwrU1NMLmNvbSBDb2RlIFNpZ25pbmcgSW50ZXJtZWRpYXRlIENBIFJTQSBS # MQIQBof4ljXihJpmCqqt2mhAWzANBglghkgBZQMEAgEFAKCBhDAYBgorBgEEAYI3 # AgEMMQowCKACgAChAoAAMBkGCSqGSIb3DQEJAzEMBgorBgEEAYI3AgEEMBwGCisG -# AQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMC8GCSqGSIb3DQEJBDEiBCDq9X7m/dph -# PALur9LPRbqQSNv8HOs5QR46QTJ8uV6tOTANBgkqhkiG9w0BAQEFAASCAgCiBFXc -# k/naW9qByhVLEPYI/VPziJ58Cj/SJ9cTj1NIJS9E76bEKnPnULLEg+mFCQZwlqcc -# xDDMrlTsVIHLxL7lJJOvoI8nCjIop+CX008If7n4ZKFk6Mpf9q9Y4pG0shOwdGrK -# vgGXoZU5rC2AzUrgZ5evWgy9gRg0Le1RQNoPGxDDaoPWE6VXTCS8MtO3M2GWxB57 -# aBshH6wvuHVofS8UgKp18KuZGK6XMEv8+/SCoe80pb13tUjajZVxnNw9lapr3iXx -# VpQnblkouLZDbs88rkxMjK9Tup1NgRcBpKR12d1k2BqKT9RwZ2XTZp33Oo7wj1Ru -# R3dVu5ADjQdBQVs5f5T9vkMy8vqBm0U7e9N86lA5FeL48tP4J6kMv4AVWLNFMR7h -# Kh1TayfepSAQUAKR0d7VgoCWStudfSyUHrZD9I/CH3qNVtA/TKpZhtKE4VE3qdoj -# h/0cvNwpKwUYArIe7jD+YInlwGu08p0v1/WNwB9NCNdru/9Vjp04uTuH+bAJkgbr -# 8JcNcG2PREThMAxxY+ilMJ96qEiMi42J1Y3JKrCdo6ptp13GlR9Vp5j/5ccZgOC2 -# mLQXB3WD0nHrpPsC31NgWiE8pfVTn8Xd/ngNe7JKH0UjW9pngkcXRO59vZ17wxfF -# yyMwIm74/nvK+mWeDXkm1FWXjrajGHSgXft2jaGCFM8wghTLBgorBgEEAYI3AwMB -# MYIUuzCCFLcGCSqGSIb3DQEHAqCCFKgwghSkAgEDMQ0wCwYJYIZIAWUDBAIBMIGJ +# AQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMC8GCSqGSIb3DQEJBDEiBCDKkbg4xwIT +# 42o2B3skr94T3phqKZO7qdqpVXQzY7ENCDANBgkqhkiG9w0BAQEFAASCAgBOy1xz +# TngmPSWUV7Lj1AK1FBOvsMcEjtdi1u4+/ealhOQDfsNHDNByLnFLzzUBm2KuKiBs +# 4aha8tlx8AjvBvQkNcLt/u8RFYB627g9hDr3kxF5OVq3wM62aFKxHy362zU4smSa +# lrKPLEolXvsuKF+/r9FH2DUdgvrbll4dZDZxv1hehZGwFiVRkOt4tKFPshu2zQ4H +# YG6QfRtAQkZ6eTsJU5XgSOy3r+rTP5ld+kO+wSXoq9CxQRjE+EgDgGoBypElpPo2 +# wHcgYZU6YvrpstLZPFtM8VqZqkq7sZQTf69pldW/FOYgRuO6mHLyBzqJKVHjtmKz +# N2hLKCoIWjf5ESv71m6/BbTD+NADOJ+NHkKrTtdIKbj9/BTanmPh0upHbAOXxGTe +# Zz+FaGW+vWkdE915ygqyi4vqbTwqyoiZFAAGGaR2RHzgZK6vxPFFxNdt6egpBZuN +# l77CCsVwp+/NwGDC1Ra3vWn3AxT8ZnavqNsqV2BkPtjD2Se3svpO6ZXBS7XkMIWn +# L7LZMHUyAErps/EQI/cLbHlS4zdng1PZ5A7gvVmU0ix2NVzxulJb9Gffb8enDy89 +# GUNNmola6v0OuhK/c4cqXcunTO8e6s4ymH+oI84ULJZp4IzbeMWBg0ZUXzYSWz1V +# 8VYAJPH4Jy05Qn8Lsbnv+tav3q+UHg30rP92eKGCFM4wghTKBgorBgEEAYI3AwMB +# MYIUujCCFLYGCSqGSIb3DQEHAqCCFKcwghSjAgEDMQ0wCwYJYIZIAWUDBAIBMIGJ # BgsqhkiG9w0BCRABBKB6BHgwdgIBAQYMKwYBBAGCqTABAwYBMDEwDQYJYIZIAWUD -# BAIBBQAEIBH137qTftgYmC7Z3Q+6jRAXrKpG9gy4hRJqaMltI7eTAghfBbZVDpYz -# hBgPMjAyNjExMTAwODMyNTdaMAMCAQECEBkH5v/p8nCU5BoFfINI/WmgghGnMIIE +# BAIBBQAEIFUnsQWTwuVVB5HAcF6cXXXuFLVSRqKJVVqNwVaTpJfzAghti0AreWsx +# mhgPMjAyNjExMTIxODAxNDFaMAMCAQECEEugJlROBCilaV6hPFG+qIegghGnMIIE # 8zCCAtugAwIBAgIQVEP4N71a7hgBhHK4XNqO4zANBgkqhkiG9w0BAQsFADByMQsw # CQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hvdXN0b24xETAP # BgNVBAoMCFNTTCBDb3JwMS4wLAYDVQQDDCVTU0wuY29tIFRpbWVzdGFtcGluZyBJ @@ -1413,17 +1641,17 @@ finally { # rDMtXndUg3qhJL4pA3ZUlo7w5lM5ml+A7ijr/3Gk2v4QRoDeE2ShmTXdHgtqo8L/ # fT119mYcETycE2NYGRXsBl3N0rzDsHRr8P3TrprqhRrX04iS0P7eQ+lDxgS3yhGn # 3OzWGhDt9Gf2x1qe0/qdhFAVOkXxzMZz4Uat6xsAfzX0+/m8GEKW5Ojw/HY+kLvV -# wzSPOzGCAlcwggJTAgEBMIGGMHIxCzAJBgNVBAYTAlVTMQ4wDAYDVQQIDAVUZXhh +# wzSPOzGCAlYwggJSAgEBMIGGMHIxCzAJBgNVBAYTAlVTMQ4wDAYDVQQIDAVUZXhh # czEQMA4GA1UEBwwHSG91c3RvbjERMA8GA1UECgwIU1NMIENvcnAxLjAsBgNVBAMM # JVNTTC5jb20gVGltZXN0YW1waW5nIElzc3VpbmcgUlNBIENBIDICEFRD+De9Wu4Y # AYRyuFzajuMwCwYJYIZIAWUDBAIBoIIBYDAaBgkqhkiG9w0BCQMxDQYLKoZIhvcN -# AQkQAQQwHAYJKoZIhvcNAQkFMQ8XDTI2MTExMDA4MzI1N1owKAYJKoZIhvcNAQk0 -# MRswGTALBglghkgBZQMEAgGhCgYIKoZIzj0EAwIwLwYJKoZIhvcNAQkEMSIEIJoU -# ahiePJDtGkxNhbiycvlY45DZrMI+3syJHO9ASsn7MIHIBgsqhkiG9w0BCRACLzGB +# AQkQAQQwHAYJKoZIhvcNAQkFMQ8XDTI2MTExMjE4MDE0MVowKAYJKoZIhvcNAQk0 +# MRswGTALBglghkgBZQMEAgGhCgYIKoZIzj0EAwIwLwYJKoZIhvcNAQkEMSIEIKK8 +# 8ULY0se+MQ8z6ldSPSwayF+NG5VduAm9ktbgtUfeMIHIBgsqhkiG9w0BCRACLzGB # uDCBtTCBsjCBrwQgV0/qF6r6XnxqK5sIyZixc15FCzhzykTmokygkw5j87AwgYow # dqR0MHIxCzAJBgNVBAYTAlVTMQ4wDAYDVQQIDAVUZXhhczEQMA4GA1UEBwwHSG91 # c3RvbjERMA8GA1UECgwIU1NMIENvcnAxLjAsBgNVBAMMJVNTTC5jb20gVGltZXN0 # YW1waW5nIElzc3VpbmcgUlNBIENBIDICEFRD+De9Wu4YAYRyuFzajuMwCgYIKoZI -# zj0EAwIESDBGAiEA1s+ESC73XnvMwRBaijql8emlCvPxZziYkW8Ofe/B6dgCIQDz -# npa4EVo5LnQW64/td43MZW4CUb2fN84nQwtbNw8BkQ== +# zj0EAwIERzBFAiEA5LWk96x19UygK8k7JKVsgzrWfuj000iGNvBeJWM/MIMCIG3r +# eoQqbmzt4dHwuWX/NFS/R0UTmYIlYZesYXh5oCc7 # SIG # End signature block diff --git a/package/PackageIntegrity.psd1 b/package/PackageIntegrity.psd1 index 1e632f3..dc21900 100644 --- a/package/PackageIntegrity.psd1 +++ b/package/PackageIntegrity.psd1 @@ -1,82 +1,83 @@ -# PRA Remote Mailbox 3.1.2 - authenticated package integrity manifest +# PRA Remote Mailbox 3.1.3 - authenticated package integrity manifest # Generated only after the final stable-file signatures and timestamps. @{ SchemaVersion = 1 Algorithm = 'SHA256' SignerThumbprint = '0F28E442889F17B5F4D251E8F96E7CC6E2C9C6D6' Files = @( - @{ Path = 'Invoke-PraRemoteMailbox.ps1'; Sha256 = 'C738CA6C403039ED1930DFBBA15390B35AD7DE2B879EDA688E5E3C688AD83183' } - @{ Path = 'PraRemoteMailbox.psd1'; Sha256 = '3EDDA302DF69B9E1162159B11ECCB7162CD8813A77A20FE2A5F05B973A30484A' } - @{ Path = 'PraRemoteMailbox.psm1'; Sha256 = '472EF4BB1678B4B1E77D53D0B6E7C1CE2AB6CA002B67A2B5E9E3D1479CA6FE46' } - @{ Path = 'module\PRA.Common.psm1'; Sha256 = 'A8CAB6EEAA735284065A9B61D47A1780DC5277F912BFB3C840B4DEB2902FCBD3' } - @{ Path = 'module\PRA.Directory.psm1'; Sha256 = '4C072DCC46BAE2232C9A539DABA6310FBE7CBF72AD18857BBE99C2B501F309A4' } - @{ Path = 'module\PRA.Backup.psm1'; Sha256 = 'FA15B71393E211490BFDFEEFE47D94CE8C0197A3C828B6AD5EA9FD5039946236' } - @{ Path = 'module\PRA.Cloud.psm1'; Sha256 = 'DC6CA84C7D1D2EADD5E66E67B9DDB5673AA75D03DB64B553209E1655CC6761C6' } - @{ Path = 'module\PRA.Gui.psm1'; Sha256 = '823626872273032CA53BBA379A7470F82B92DF268095FBE9D13A7C25BEE3C84D' } - @{ Path = 'module\PRA.Gui.Directory.ps1'; Sha256 = '335A30A4DFD5A99E3751B77E71F8525EA76EEE044CE9E58EE991FFF551D48FFA' } - @{ Path = 'module\Test-PackageIntegrity.ps1'; Sha256 = 'D514F073AE42EE6D3316A0A81F9631F30EECBF132DCBFA7EEDA7330B149BE17A' } - @{ Path = 'module\PRA.Gui.xaml'; Sha256 = 'D392FF147CB10F853387BFA58F1330D974C2CCA309DFC2278051654AA06719FD' } - @{ Path = 'templates\Report.template.html'; Sha256 = 'BC9F3246EAD4B9DB12309F73CD2596FBD814DE9A779BCB1BDD75B5C4687670EC' } + @{ Path = 'Invoke-PraRemoteMailbox.ps1'; Sha256 = '01B0D73F5D6A0EBD0FADA2C48922C08A75046DAEE5FB32BBB2D44B113B0D7765' } + @{ Path = 'PraRemoteMailbox.psd1'; Sha256 = '4622DE388035005966E1531A3554F15C8D9DC0BF45C7D75C95149673A38E820D' } + @{ Path = 'PraRemoteMailbox.psm1'; Sha256 = 'B473126FDF7194D1B78F92A0A1B5CB1E7E5B46ADDB5FEA603C1714FDE696FD77' } + @{ Path = 'module\PRA.Common.psm1'; Sha256 = '8574F29E01BABEB784AC91E4AA305B60D1897D0E4603052627F562E497CC4311' } + @{ Path = 'module\PRA.Directory.psm1'; Sha256 = '7C42651F19CED979DD66B72231A38B144B5258503DB66C09AE912267A9FA2D31' } + @{ Path = 'module\PRA.Backup.psm1'; Sha256 = '0529EEEB53A3F108BE080AF91682E0C1923EE0C941685161DF1BCE0B6A1084C1' } + @{ Path = 'module\PRA.Cloud.psm1'; Sha256 = 'FA002BA33BF0ACBCCAB3506A0F4B16ADC2E24F02399B58C860F8AB7BDB0CAE82' } + @{ Path = 'module\PRA.Gui.psm1'; Sha256 = '65B0D0BC9A6A101894876431554A05F05B51D61105CE38C66C9ED005D0AA5C2C' } + @{ Path = 'module\PRA.Gui.Directory.ps1'; Sha256 = 'B54506FD9813ACF6A266C5A981F88150702A3DE43E06B70BF95703D7EF63F308' } + @{ Path = 'module\Test-PackageIntegrity.ps1'; Sha256 = '98ECA0021AFB8A53243712992E61A3A6F9B2EAF96531EA7EDDC1A7FA8F10AE21' } + @{ Path = 'module\PRA.Gui.xaml'; Sha256 = '2DBCB014EC62F47A28DD3DAFB03C4ED7B646648261EA99B9488CFD712BA02F48' } + @{ Path = 'templates\Report.template.html'; Sha256 = '0259507E65773EC0CF74576F1EE293C8C56AD8E3C92CD757244EFB74096C1C32' } @{ Path = 'config\Targets.sample.csv'; Sha256 = '564C746AFDE5A5EADEBFD4449A7BB372B4D63E8B7C8352ACF825458650A458EF' } @{ Path = 'config\SharedPermissions.sample.csv'; Sha256 = '7838261190B01E705505EAE8C1664FCFD9143E4E3F39D3E0968A02A0B7951B5F' } - @{ Path = 'README.md'; Sha256 = '021FB9627A22BBC9134BD4C6CF5FEA8A02522D82881C4C41C86867116BA9D0E5' } + @{ Path = 'README.md'; Sha256 = 'D4201D4E5E26184932FF78C46D757520FD0505855603B00A370180FB9751798D' } @{ Path = 'LICENSE'; Sha256 = 'A91A28EED601C15D06E439F83666F0EBE1AA7897DE37D350108147C7804FD94B' } - @{ Path = 'docs\PraRemoteMailbox-Guide.html'; Sha256 = '20ACFDBC40F607B3920397600AB9DE635776F5F659F2FE0345DB7A964E90AE3B' } - @{ Path = 'docs\PraRemoteMailbox-Guide.md'; Sha256 = '28D7461E465C6C038C8E82294BAAB31329F8C919EC67305B8E1D62074FE887B1' } - @{ Path = 'docs\PraRemoteMailbox-UserGuide.html'; Sha256 = '1966959CBDBF8E4462FFA36F1CD987AF8FBDE3F412D571F74FB7588822080D4C' } - @{ Path = 'docs\PraRemoteMailbox-UserGuide.md'; Sha256 = '3A16A8CC0DB8856EFD669014664459319DD52A3F9C23A84B4881745C230FC3D7' } - @{ Path = 'docs\images\console-next-cloud-light.png'; Sha256 = '71F1828DE23288E41A65850B702BC7AC364308E9C023AFB8F86014565BEBAC01' } - @{ Path = 'docs\images\console-next-finalize-light.png'; Sha256 = '3337D271231C52739DAC067C0A52788D6E921B3A08D8ACC9895F6B662C95852A' } - @{ Path = 'docs\images\console-next-global-light.png'; Sha256 = '87111B9A401A97788F138C18E5E514369DA725AC91E237803A681DFC7EE13A3E' } - @{ Path = 'docs\images\console-next-light.png'; Sha256 = '04E05E676652C46595868C23E9E02F65CC9D224EC6D1F3A1917258887E3F23A6' } - @{ Path = 'docs\images\console-next-package-light.png'; Sha256 = '8E44533D46635054B67F281A99F7A0278FEC099D36B10BE51B39D713CF72AB7A' } - @{ Path = 'docs\images\console-next-rollback-cloud-light.png'; Sha256 = 'FE356017382C8EB4EE727237E09704214BC7717840A6D3962B90281E7D46F2DD' } - @{ Path = 'docs\images\console-next-rollback-light.png'; Sha256 = '92C5876B2767F38F1629F54A25F61EADC778B46439B557902D3CD09EAC6E8E6D' } - @{ Path = 'docs\images\console-next-rollback-package-light.png'; Sha256 = '758EF6355635B279D83DFEEB8F60E43B7240324846AA3D8D218C8749E40AA209' } - @{ Path = 'docs\images\console-next-syncfailed-light.png'; Sha256 = '047416510C090764791F3F5651FA926470B57544359895A25A42A66E7D2130C5' } - @{ Path = 'docs\images\console-run-cloud-light.png'; Sha256 = '0BAC232097FB2679C9A2FABB959336258DDC6C62D652C2DE6E54F9147C28E5D4' } - @{ Path = 'docs\images\console-run-early-light.png'; Sha256 = '543304CEB625A8644BC69BB4509D77C44FE856FF0BE7E9A6CF056C0E85B6B180' } - @{ Path = 'docs\images\console-run-finalize-light.png'; Sha256 = '3156987545CC888DC2F48F518F042593FD5A22518F571570AED299A7870E1C6B' } - @{ Path = 'docs\images\console-run-finished-dark.png'; Sha256 = '84699274E9634C5106BB418214A81E8DE679DD5344C84F3C547DC7E99AB5EC86' } - @{ Path = 'docs\images\console-run-finished-light.png'; Sha256 = '4D8E6A8C1CF311A6F7E10ED65B9655FE57B31E1CAEB7F74583BF09FD2A4F575B' } - @{ Path = 'docs\images\console-run-grant-light.png'; Sha256 = '55D81968BB96FCF111C7D6B81DAC1FFA89AE48C7F174A4DE007810A0F6C2CFBF' } - @{ Path = 'docs\images\console-run-package-light.png'; Sha256 = '62F5525ED5E757A0B31BEFA5F1F1A138A52142AEB4F85EF6D9CCA746C4B6B3B0' } - @{ Path = 'docs\images\console-run-rollback-cloud-light.png'; Sha256 = 'B5085373F5DD00D958404DE99B3431D286F9DBEB88582ED8ED2842776B05E668' } - @{ Path = 'docs\images\console-run-rollback-light.png'; Sha256 = 'FB3FB4489C7F30AEA36584CDC6407B716E819381BDD5EC70B141909B16A7EB1D' } - @{ Path = 'docs\images\console-run-syncfailed-light.png'; Sha256 = '84E254C45C58AA1CCC8E702236DD58E8FB5111D9E950C916D9ACDFF8CB36F125' } - @{ Path = 'docs\images\console-run-waiting-light.png'; Sha256 = '3659DA4B35C0906F7CCF5EB2D2D5C147CA0F5ADB6918355ADB08E83B88D1351D' } - @{ Path = 'docs\images\console-settings-light.png'; Sha256 = 'EF2ADC1BDB99DC35C99FB30E954C4D28DB7E426187F064D435C4EB40F2B3AF96' } - @{ Path = 'docs\images\console-setup-dark.png'; Sha256 = '51ABD9B63AF6020D80951355EDB266E3D36F72FC6DEE1CEEB38C2B117EAC738B' } - @{ Path = 'docs\images\console-setup-light.png'; Sha256 = '4FCE6B95672CFF7AB6654DB374DD3AFF7007CDA5691DAC03EEADFB317B04B369' } - @{ Path = 'docs\images\console-setup-lights-light.png'; Sha256 = 'CF604E42C3BF8B0E832B9AA387D5C74590F5FB50A31BB5FAD7D524884E436ED3' } - @{ Path = 'docs\images\console-setup-next-light.png'; Sha256 = 'FED89B818EC538FBD2D610B3A8E579882C2C97B887074AB45770826E90F96DB6' } - @{ Path = 'docs\images\console-setup-red-light.png'; Sha256 = '385DCD0A0A3D9079FFA475F45541827FC964FF81DBBE987206C2A2E0D003F465' } - @{ Path = 'docs\images\console-setup-red-lights-light.png'; Sha256 = 'E69DE09332E46A19EF784768E7F9369A754E0971DC0B8583CC7A4B0FD85DF336' } - @{ Path = 'docs\images\console-task-ad-light.png'; Sha256 = '3CAC8C065C07D2E6ABD6C9AD1DF77DBDB3B12305CEA1247448904FE6DEABB33E' } - @{ Path = 'docs\images\console-task-check-light.png'; Sha256 = 'F168838703AC124590164589BB3BAA8C918DB96AB8DDC0251034B3B25B812877' } - @{ Path = 'docs\images\console-task-continue-light.png'; Sha256 = 'B07C86800907F2578DF27007FE6035C1CE54D207B54B0B0D690AB8D427F41711' } - @{ Path = 'docs\images\console-task-finalize-light.png'; Sha256 = '912EDFBD791F28D4A63308137BFD0177B30D57426FD98958ECCE5D994EFDCCE2' } - @{ Path = 'docs\images\console-task-finish-light.png'; Sha256 = '5C103D2B1E5D31009797D32768EEA31430196863C0E6C3D9C6F3FE23EFF0889F' } - @{ Path = 'docs\images\console-task-identity-light.png'; Sha256 = '4DCFFA042D02F3AE923A69E4B8BE9ED7669F752EF38B4DE6BD3439214F3790F1' } - @{ Path = 'docs\images\console-task-light.png'; Sha256 = '23650ABDFB8D3BA91CAD3703F4D58BD79E576AF8C38D236F7E4F7CD430D9E7A9' } - @{ Path = 'docs\images\console-task-package-selected-light.png'; Sha256 = '5E3B4E429F853070238A384E829ED8621A4D1D7E30C6516D7048DE96412243E2' } - @{ Path = 'docs\images\console-task-rollback-ad-light.png'; Sha256 = 'EC4D2D1D89E41B3426355741B955A68FF4C5EBF17B155272BC60197717CFFD66' } - @{ Path = 'docs\images\console-task-rollback-continue-light.png'; Sha256 = 'CF5340C0C4C522F77A27D2C06513B270A6FA20827B4A0D697129DCC7F1F86BC6' } - @{ Path = 'docs\images\console-task-rollback-light.png'; Sha256 = '8FF49197F729FE886387B9AC458EB52B499AABC8810C3B7ED260330B2BC45348' } - @{ Path = 'docs\images\console-task-rollback-package-light.png'; Sha256 = 'CC74FE63FDA5E8B99351F48A5CACB2B0C53454248C2289FE66CA8A7D90F2C437' } - @{ Path = 'docs\images\console-task-rollback-selected-light.png'; Sha256 = '3F399794A3E69E91C11ABD8EAB2A42301DAAAF819508B5169192DB78B6149F1B' } - @{ Path = 'docs\images\console-task-scope-light.png'; Sha256 = '2734D2EC782656B99A8997959E765E5A1D22DF84D532C0D8A53CEEB338556657' } - @{ Path = 'docs\images\console-verify-before-light.png'; Sha256 = '94F68BF22C6EF8A2FB2E3AD3B9C716FB569EDA02835C1220945E245AEDCD818D' } - @{ Path = 'docs\images\console-verify-check-light.png'; Sha256 = 'FD565780427CF2A52FB77D3CAC891CF1BE7391B5E0BDD809CC5A15FAA94DC533' } - @{ Path = 'docs\images\console-verify-cloud-light.png'; Sha256 = '8AE953ECA3A6FD5448902805A049235CB784CDC44E6796520D4615651FAAB520' } - @{ Path = 'docs\images\console-verify-finalize-light.png'; Sha256 = '831FEBA0F5AA2669E1344068BADEC88B1B288588817F5141666B550AB2B47068' } - @{ Path = 'docs\images\console-verify-light.png'; Sha256 = '7448AB5E1124C08FBA26BA55CCBED8108DD7AA0D43EA0787670C52917F568A8F' } - @{ Path = 'docs\images\console-verify-rollback-cloud-light.png'; Sha256 = '3A052D4F6DD52BE2EFA09E6EF2A0CB1ADF8D22C6296E646D4FA381683AD1051F' } - @{ Path = 'docs\images\console-verify-rollback-light.png'; Sha256 = '91846AC0A6480E95D5A1C7F8D2643B06AD61DF8260853FD1DBD8CBACB841165A' } - @{ Path = 'docs\images\console-verify-scope-light.png'; Sha256 = 'B4BB47C7BA8334B2C03D4427FB91FE1D3041007E3697A9BEAB4C461DCD970281' } - @{ Path = 'docs\images\guide-dictionary-light.png'; Sha256 = 'E186BE9EC2E1E121503D4B86C67761AA1ABCD63C7D79827C1DB7E019851D6BD9' } - @{ Path = 'docs\images\readme-banner-dark.png'; Sha256 = '11B93190CCEAD066DCB11701789598B74BC5A848583E5DC38114581FC998CFBB' } - @{ Path = 'docs\images\readme-banner-light.png'; Sha256 = '2EC554756EC77EF7D0D3DC5D03827E4733CDA689E16C4A1862695E679E0A0FE4' } + @{ Path = 'docs\PraRemoteMailbox-Guide.html'; Sha256 = 'AC1B49732AC678D4E6B631701BE0D9885B6E0C8024EBF599B81A55EA46AF08AB' } + @{ Path = 'docs\PraRemoteMailbox-Guide.md'; Sha256 = 'E6F4BE02085364DE67484E717F86C2A0FD38E821FA89332C9E8A892952F9C9FC' } + @{ Path = 'docs\PraRemoteMailbox-UserGuide.html'; Sha256 = '0DF4329C27E10ABF0FE7DF5D40094FB3BBAAD9E5F0B560004AE7ECB952A124AA' } + @{ Path = 'docs\PraRemoteMailbox-UserGuide.md'; Sha256 = '48FC32F6B7132445EBB18CA22E5DFD81C18F53B578187DA3662B4AB7748B6745' } + @{ Path = 'docs\images\console-next-cloud-light.png'; Sha256 = 'FA5E285823A6CBFDF8598623DECFF646A34737C49070EDAC2FCD2DE3B951AC03' } + @{ Path = 'docs\images\console-next-finalize-light.png'; Sha256 = '8CFD99F70F7FD51AD358CFD49E4F439D403208AF06A74CE82DD28D29B38655FC' } + @{ Path = 'docs\images\console-next-global-light.png'; Sha256 = '9B45EA5B3C32C423FE3ED9D5E059075890A60479208DAD3655825B981C1F98B7' } + @{ Path = 'docs\images\console-next-light.png'; Sha256 = 'DA537AA77C72D04D579B95F7B47DA0942B6FFD0E2F51239BAC8AB315C8FEED77' } + @{ Path = 'docs\images\console-next-package-light.png'; Sha256 = 'DF003129B27A4D76EAD61172B1AA154AF63BFE2A2AE91456FCE83E84764874DA' } + @{ Path = 'docs\images\console-next-rollback-cloud-light.png'; Sha256 = '38C225C0394A4AD2B3C67B302B212B7E5C815810E243D6F31D3A246778FBDECC' } + @{ Path = 'docs\images\console-next-rollback-light.png'; Sha256 = '71BDD4A711A1DA81DCD36EEB1953E9ED2C409A1D9A396607DA6E26329FD7E133' } + @{ Path = 'docs\images\console-next-rollback-package-light.png'; Sha256 = '4A1976BC1BA31C477A8092E14835788C977C88E3572D049CE2E4632681189FDD' } + @{ Path = 'docs\images\console-next-syncfailed-light.png'; Sha256 = '43F58F978DF72552D830342CEC3291BBCC31F58579B64CEDFF62A4FC26A34611' } + @{ Path = 'docs\images\console-run-cloud-light.png'; Sha256 = '434A292B5F908708D01E35F05C5C9C04BC92F56F90448F7602CE7BEA889EFE45' } + @{ Path = 'docs\images\console-run-early-light.png'; Sha256 = '3224AE3FEC23FF0D1D0D7733567B59BE3FC015E34BFBF31D12E7078758B76D72' } + @{ Path = 'docs\images\console-run-finalize-light.png'; Sha256 = 'AD98B2634A0D9C7E034EA6327C67485C56725F7E7D971E4B5051D4433355228F' } + @{ Path = 'docs\images\console-run-finished-dark.png'; Sha256 = 'F77E4C2C59E7141A4ADC7D16FCAF556A816659A9697B6BE3D77A491ACA5E0AB2' } + @{ Path = 'docs\images\console-run-finished-light.png'; Sha256 = '2CBC194B876ACA6188B3F84A08200FD9B1E003DDDDC89F70A98046E0769AC396' } + @{ Path = 'docs\images\console-run-grant-light.png'; Sha256 = '8480533B40B81F14C31E8E9CC5095F9277443416FDBEE0DFC9266C986F1A521A' } + @{ Path = 'docs\images\console-run-package-light.png'; Sha256 = 'B14E2B806972C21562243953AB6DF552705BC1166A66CADC35CBBDA8E44A0831' } + @{ Path = 'docs\images\console-run-rollback-cloud-light.png'; Sha256 = 'D96B405E53F46A86EC5CC32A5438C14203418ACDDE40A26806D406E7BF1B050B' } + @{ Path = 'docs\images\console-run-rollback-light.png'; Sha256 = '49017D9467B67A006A4FC3B7A74BA6BFD58B093941E8DCA2AC8407F17BDB5556' } + @{ Path = 'docs\images\console-run-syncfailed-light.png'; Sha256 = '1F2D58C75FFF761F8090C7642FA63C5E7B751543A40C0E2AA963E8792E60C5D0' } + @{ Path = 'docs\images\console-run-waiting-light.png'; Sha256 = '918B9EEF4E7E52DF1EAD0440829A527FD08D4886C9E1E17C0B9FE03F024F89FD' } + @{ Path = 'docs\images\console-settings-light.png'; Sha256 = 'AE1C865496AEC85B3AF5B4EFD55D5AF5AD3B6AC39225803616B4A2A789F11E54' } + @{ Path = 'docs\images\console-setup-dark.png'; Sha256 = '82944AF353FEB19BF26B158D45CC13B34C163CE37F4C7915CA7A013ED45E311F' } + @{ Path = 'docs\images\console-setup-light.png'; Sha256 = '6B7B5B75A51417537280D0535AE0500BC4A3104E515DF38E234F0C56968FD77F' } + @{ Path = 'docs\images\console-setup-lights-light.png'; Sha256 = '025A1A52F8B55C247B99107186D9CBA05765BFD70DD7365CB9A9615E95614219' } + @{ Path = 'docs\images\console-setup-next-light.png'; Sha256 = '1E3BB84869971027F88F92AB4499601425F70C1CB5003A009CEB7CC6E2F77E07' } + @{ Path = 'docs\images\console-setup-red-light.png'; Sha256 = '8B64FD348EEF66B4DE8790C34BBB1153E4E9CD9CD065FF63909B324F5838020E' } + @{ Path = 'docs\images\console-setup-red-lights-light.png'; Sha256 = '258F672EBE91826DAA7669F4A367D5936439E89B9FBEB14685B9CF66A81F87AE' } + @{ Path = 'docs\images\console-task-ad-light.png'; Sha256 = '745B9B1BAD7BA38D02DB05DD6CA3E1A261661D50D3ED6911B5F4D83146B40663' } + @{ Path = 'docs\images\console-task-check-light.png'; Sha256 = '92F3AEA9355FF4B46E8C31E990893779B3BE58B23324FCEA1AED5E4A6D4A4E86' } + @{ Path = 'docs\images\console-task-continue-light.png'; Sha256 = 'FAA5D65FB50E7B6BEA147F2586166D8FA6306B1F0F0C848FAAE9B49E1CD4ACB8' } + @{ Path = 'docs\images\console-task-finalize-light.png'; Sha256 = 'AA5B497314224E4CF567F28F3BD7CD0CEEDD940C86EDA8F395EC0D56F3A90578' } + @{ Path = 'docs\images\console-task-finish-light.png'; Sha256 = '5A314AE9E156CC57DB25F6094402FD689081FAE78AFBE7EF0940103144693242' } + @{ Path = 'docs\images\console-task-group-light.png'; Sha256 = 'D5D21AC1B902935EDABB76B2215C01D2BA91982A6781589B5B4EA45600513626' } + @{ Path = 'docs\images\console-task-identity-light.png'; Sha256 = 'AC98FA96D7DAC280111529EBA5CAC1EAFE27CBE88724540BBEB6E7A47C5EAC7E' } + @{ Path = 'docs\images\console-task-light.png'; Sha256 = 'FD110973521EB75E17CDE4AA07F96294792BA51F52C0546FB710F4EBC7CB59CE' } + @{ Path = 'docs\images\console-task-package-selected-light.png'; Sha256 = '0B7C18FE1CA6C4CCD2DAE06D648F76476BFE0065017975FB48D0557E4618647A' } + @{ Path = 'docs\images\console-task-rollback-ad-light.png'; Sha256 = '0EA70D165823D420D1864F6D87972691FA36CC3C881582734AB2D4068E29742C' } + @{ Path = 'docs\images\console-task-rollback-continue-light.png'; Sha256 = 'EED1F1317A0CD61F1FEB08FB00B9FEB443A15C7423B94E00C3C6168A95DCF87A' } + @{ Path = 'docs\images\console-task-rollback-light.png'; Sha256 = 'BABB5AD9BA18673CDA8ED18BB2FED26EBB4539254BB1B78515418CAF01811BF9' } + @{ Path = 'docs\images\console-task-rollback-package-light.png'; Sha256 = 'BE808B77FA96D8A6593C7E02003044A48E0D041B32B0E7989628CF68F0FB1B5E' } + @{ Path = 'docs\images\console-task-rollback-selected-light.png'; Sha256 = '8D2EA18AB683BB3C83F781BA6F71929C66EA4F090D493E494ABADC2A2A8165EB' } + @{ Path = 'docs\images\console-task-scope-light.png'; Sha256 = '16639AB0848ECC60E6FA9B45D0AB95F7ABAF44173405EB445CA19B346AF67949' } + @{ Path = 'docs\images\console-verify-before-light.png'; Sha256 = 'C179DF335ED2C96ED89828C8859ED32C45EFB9FAAE263756A0BD218A57967A11' } + @{ Path = 'docs\images\console-verify-check-light.png'; Sha256 = 'B62875690EE9643431D6212B7E038549B97A63C1EC86568449E97EA76F19145D' } + @{ Path = 'docs\images\console-verify-cloud-light.png'; Sha256 = '8DD1285A42C828F966697221C61FE58670ACB1DEAF98D42295C3F5BD1CE2CFD8' } + @{ Path = 'docs\images\console-verify-finalize-light.png'; Sha256 = 'F13807B04EC5B38CAD102B34D40BB7AB4E6109F60CED3FEFE9CB34901DAF6FA8' } + @{ Path = 'docs\images\console-verify-light.png'; Sha256 = '7EE92A3A2AA61142824774A72531125F3CFD66375A78773B273B5F5AC5FAD331' } + @{ Path = 'docs\images\console-verify-rollback-cloud-light.png'; Sha256 = 'C662491E778FBC794932C9328108D88AF5C269318DEDD25F8713D6D1F403F3D1' } + @{ Path = 'docs\images\console-verify-rollback-light.png'; Sha256 = 'B2C067D6A7175280D0CB5772A5FA73B9A1E85DB57F3627A2E61FE9A039C0A57D' } + @{ Path = 'docs\images\console-verify-scope-light.png'; Sha256 = '4D50B9E8710C6FC5A7A39493A34D1B2750555DA494C875E3332648BDA81632A1' } + @{ Path = 'docs\images\guide-dictionary-light.png'; Sha256 = 'CCB62F52E60CBC27196C454A31892EE3AA68A88650040C397AEE01B69639E112' } + @{ Path = 'docs\images\readme-banner-dark.png'; Sha256 = 'D104F8487E1AEEA008D218E81D4BB98BBFEB8A7A915164BEA6CEC0B9910A9D92' } + @{ Path = 'docs\images\readme-banner-light.png'; Sha256 = '7656DC4404E315DA1B384C5CB9370C3EB4A39C41EE9CF9C2F823E2EA9C0A3B1F' } @{ Path = 'docs\images\readme-flows-dark.png'; Sha256 = '5506575A6FA0729673A8C4FB5C1852D39E449B49104706C563E752DAE21D2EA4' } @{ Path = 'docs\images\readme-flows-light.png'; Sha256 = '169597ED1DB78B467B727C762D2E5022CFC67C355FED405B529F49C9CCC7C081' } @{ Path = 'docs\images\readme-how-dark.png'; Sha256 = 'D294589619F38AE783DE83F64E84F27475367D17F1C1CEE4FDD08E80F5D7E807' } @@ -89,23 +90,23 @@ @{ Path = 'docs\images\readme-principles-light.png'; Sha256 = '4970A77A2D963DAE186DF073BB0C02A22F18C681F95B9FCB579E8F5CD05AB8EB' } @{ Path = 'docs\images\readme-rights-dark.png'; Sha256 = '014D627D728DC80226E14CD5CF70517B3C76E436B003A0F08CFB68524E224193' } @{ Path = 'docs\images\readme-rights-light.png'; Sha256 = '7ADC50A94328BB7878DAE8A92EE2861566947BC2A30A076040DF00C8499B0302' } - @{ Path = 'docs\images\readme-transfer-dark.png'; Sha256 = '48EF7AB4A62BCFF08EFE7B13D2AB99DAA0BC4F36F59847764BC97DB9097D7705' } - @{ Path = 'docs\images\readme-transfer-light.png'; Sha256 = '850E97145B6FD9C363A36CA9BDD6A2582A0FFFBEE2726300830DD649FADED448' } + @{ Path = 'docs\images\readme-transfer-dark.png'; Sha256 = 'F84814BF78615ADE03A7B469E32DB1920AE6F3D6F6D0DA90827FFADC38CDEB35' } + @{ Path = 'docs\images\readme-transfer-light.png'; Sha256 = '22D2935904AF42AB10928B1E2656E4024EB947E58C021ABFBE67871D54854328' } @{ Path = 'docs\images\readme-why-dark.png'; Sha256 = 'A22E81936573F37500D99D54040269F39EC0BDF99E997F350FE3BA68CFE5E997' } @{ Path = 'docs\images\readme-why-light.png'; Sha256 = '91C0E1F0AE64D464B08175F2D2CE91582023ABEA42B24049D49F231AE54A9097' } @{ Path = 'docs\images\report-global-light.png'; Sha256 = '6D15E55A6A1C2805EB732F0AF99D8E527E783F5187BE4CF070071F494BC40498' } @{ Path = 'docs\images\report-global-recover-light.png'; Sha256 = 'B17E6B7F06B438C2D22F43D0B1542341253AD2DA6586F2E51442ABD458BFD7E8' } @{ Path = 'docs\images\report-phase-light.png'; Sha256 = '4F62AAFF87FC0C7E7DFF38032F8FDC4BBA6A6FC0373611A01C54AD8603D4CA93' } @{ Path = 'docs\images\report-phase-warning-light.png'; Sha256 = 'DA0622931FC47CACC1388E378D569BB7D64B1FCE1279EDDD0F95ECCB9DEC41A1' } - @{ Path = 'CHANGELOG.md'; Sha256 = '4241E65C0B2A0EC075C222724F083CC25BF4ED10C4136B3C06B4D4B263AD7EE7' } + @{ Path = 'CHANGELOG.md'; Sha256 = 'E767D480452829FDD81FE9A106D88353BB78EB8FC0166302B9AE79B052B9D3ED' } ) } # SIG # Begin signature block -# MIImKgYJKoZIhvcNAQcCoIImGzCCJhcCAQExDzANBglghkgBZQMEAgEFADB5Bgor +# MIImKwYJKoZIhvcNAQcCoIImHDCCJhgCAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG -# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDI3yLeobVjVl8i -# r7tUfpCe+rIA6Yab47TCrwkNjERRUqCCDW8wggZyMIIEWqADAgECAghkM1HTxzif +# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDSHDmTWDvcmSlw +# Zk5xIDELU8llxL6e2nfeBokoWTxbk6CCDW8wggZyMIIEWqADAgECAghkM1HTxzif # CDANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMx # EDAOBgNVBAcMB0hvdXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8G # A1UEAwwoU1NMLmNvbSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IFJTQTAe @@ -177,28 +178,28 @@ # ULeH38N0Vr83psiJVuBSxQyt5nRVrpYz7FACq5gtXELkyViq/rGOlJKaRrgQ6WWq # eoIXqKhVFAdP/jAEm2M8ezoVYsUgPyKY2OcuecV9coulAcxUIUydx6qYiOfsGj5u # Dy7l4aYjvB771wkUMzUQwxzcDYXJtMMTaWRe6n9EemR67jc73u5CJyFg3PfA5WR1 -# wZislcdCZuS6MYIYETCCGA0CAQEwgYwweDELMAkGA1UEBhMCVVMxDjAMBgNVBAgM +# wZislcdCZuS6MYIYEjCCGA4CAQEwgYwweDELMAkGA1UEBhMCVVMxDjAMBgNVBAgM # BVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMREwDwYDVQQKDAhTU0wgQ29ycDE0MDIG # A1UEAwwrU1NMLmNvbSBDb2RlIFNpZ25pbmcgSW50ZXJtZWRpYXRlIENBIFJTQSBS # MQIQBof4ljXihJpmCqqt2mhAWzANBglghkgBZQMEAgEFAKCBhDAYBgorBgEEAYI3 # AgEMMQowCKACgAChAoAAMBkGCSqGSIb3DQEJAzEMBgorBgEEAYI3AgEEMBwGCisG -# AQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMC8GCSqGSIb3DQEJBDEiBCAyCzAHxqpa -# HtIh7EedI+eGlddFj5rvLyXhO4CauY9VQDANBgkqhkiG9w0BAQEFAASCAgAm2Jj6 -# kusYarTKGcIxSnvv/lKIa0yXMk5s82ieQKGfDh6gssnb3krh67401X4xEy6F3iaq -# pxpiVzTsfd5/VZzqjO31GwM08HKo0kB6ML1Nh9oBjLXofC9Wr0C4pX40Ac4psbuR -# bHKdGIZwBsPXmy3wQT9h4FJiHlwdFQcXVL2iHZ+ejjBBKZdUAo0V+lVT1NOdOYNJ -# j26a0Qyb3Cb10DqUs5pTisg5BYEd5OthuGe99qPYrm2B1Q3QtuFMiPM2PTz56wWZ -# +JlUCAMQQeea3bHF0QDdnnBhWIXuqbO/bwXgOTnHcClZxqQ5IhCfyLzhaHAOgZIK -# LpbUlJWNEcMozdGq4+r+t4FM/m97LqEs04K+cqZ9xtZXsPMUz65+X5OqcP0aQpAZ -# sw4h/u9AMPd6wsB8Z6i4rvEuMvbDrx/meayrqOtx/6c/IUlg7sLYkx25lnNVK88t -# /iDqB0nB6vRTdCYOv/Jnv7/R3JkmC24quxHxxoaeyWgXLjOA8hBR55WIVkG6qK3H -# eGLDeYvnWaFRiUcWyPwH5M4i3Qdx/tGTyhYPiqkpFFyaRUzZy6mDHspQiw14zeWy -# Vw0/B4NTZQSumHk5SfswevPN8coIm0YwSe7tTk/5HRjsusRTc7sDY3+yMD92iPdh -# P3q7jKkxBOxzbmKCUXGIgZds6qj30cvubffb1qGCFM4wghTKBgorBgEEAYI3AwMB -# MYIUujCCFLYGCSqGSIb3DQEHAqCCFKcwghSjAgEDMQ0wCwYJYIZIAWUDBAIBMIGJ +# AQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMC8GCSqGSIb3DQEJBDEiBCC8Ts4USf/Q +# MSHga4NIr7XxdMXOiSeUgqaG7vAbpALJlzANBgkqhkiG9w0BAQEFAASCAgCSPd/k +# Cm87VFDp7CsBD69XYEQIQcfPaYbO70Su8ZBnMVfvqPuxl0l/REwl1kVS4aTmbbkp +# NggG2+qt/GiqJp/G7uX/mtlpcWtBKmbdC4QJPHwCuKTfrDD0PYKdk193acSrv6o7 +# 5cR3VgC0o6+/jSwcpeRb71cmuSQmxaxXe3EpHni/g3BOY5Mxk2cYD74ss7CPo8zJ +# /ZmWXSXWVI5gWyblRduPID6fjqaY4rSFa7miNGdiGiPxW5HT8vTNghq0BEiuvNOG +# NA9+0I2RmCTAyIzlBd0L/6spYs4xMWyqrGM6TH2Jz/R/lWiJLydtOaaC7ZAfej41 +# n6hDQw7rIpKl3EUv68Pqp/Mef38mK0eOmfMZeU2dA5XJuWBz0BIq347E9+Pxx0uX +# PnOxKoDihhry6cBK77027H8uZux5HQxfjGTdKZpMBKBaoPemj5/jQAlEm1RmvY7T +# 1J8J0mHLvRWPk+tBLkQkSKCJtfTH0lVqKLfA+mq6jPYNrw4W6oSrzGz3p2/ubvFa +# wZckfLS33RY9C6zRCwqAaDavR94niNmOmKVgaskCT1mzhL0kHkKOpab/rcFV05zC +# uVB7Ip67TwSuqFVfOYA2YnmS63SKnGXNB4dkP4usD7F2rc8hTQV3XAu1iRBNFSuQ +# lI1swJrTrrP8qOccjc7zS2c+NBgM2oMRBR9kM6GCFM8wghTLBgorBgEEAYI3AwMB +# MYIUuzCCFLcGCSqGSIb3DQEHAqCCFKgwghSkAgEDMQ0wCwYJYIZIAWUDBAIBMIGJ # BgsqhkiG9w0BCRABBKB6BHgwdgIBAQYMKwYBBAGCqTABAwYBMDEwDQYJYIZIAWUD -# BAIBBQAEILd/1cb5/soLkVZaoVuqN8viSEt/EyYFO9cyf13JR2rYAghktH/oaryX -# PRgPMjAyNjExMTAwODU1MTZaMAMCAQECEE/NXnpcM9PHkNx7jJGncnegghGnMIIE +# BAIBBQAEIO62DOR/bPGq4M9BOr3Bl6SXk0CE9CFS62OdeT1PaZEtAggpgy4P0UGW +# qhgPMjAyNjExMTIxODA2MzlaMAMCAQECEHHxwVqdETz7ok0No9VK3RGgghGnMIIE # 8zCCAtugAwIBAgIQVEP4N71a7hgBhHK4XNqO4zANBgkqhkiG9w0BAQsFADByMQsw # CQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hvdXN0b24xETAP # BgNVBAoMCFNTTCBDb3JwMS4wLAYDVQQDDCVTU0wuY29tIFRpbWVzdGFtcGluZyBJ @@ -293,17 +294,17 @@ # rDMtXndUg3qhJL4pA3ZUlo7w5lM5ml+A7ijr/3Gk2v4QRoDeE2ShmTXdHgtqo8L/ # fT119mYcETycE2NYGRXsBl3N0rzDsHRr8P3TrprqhRrX04iS0P7eQ+lDxgS3yhGn # 3OzWGhDt9Gf2x1qe0/qdhFAVOkXxzMZz4Uat6xsAfzX0+/m8GEKW5Ojw/HY+kLvV -# wzSPOzGCAlYwggJSAgEBMIGGMHIxCzAJBgNVBAYTAlVTMQ4wDAYDVQQIDAVUZXhh +# wzSPOzGCAlcwggJTAgEBMIGGMHIxCzAJBgNVBAYTAlVTMQ4wDAYDVQQIDAVUZXhh # czEQMA4GA1UEBwwHSG91c3RvbjERMA8GA1UECgwIU1NMIENvcnAxLjAsBgNVBAMM # JVNTTC5jb20gVGltZXN0YW1waW5nIElzc3VpbmcgUlNBIENBIDICEFRD+De9Wu4Y # AYRyuFzajuMwCwYJYIZIAWUDBAIBoIIBYDAaBgkqhkiG9w0BCQMxDQYLKoZIhvcN -# AQkQAQQwHAYJKoZIhvcNAQkFMQ8XDTI2MTExMDA4NTUxNlowKAYJKoZIhvcNAQk0 -# MRswGTALBglghkgBZQMEAgGhCgYIKoZIzj0EAwIwLwYJKoZIhvcNAQkEMSIEIOmr -# +QOmMN2OUwVfW304qCnA32gVPoSsAaMuYXW6fF+oMIHIBgsqhkiG9w0BCRACLzGB +# AQkQAQQwHAYJKoZIhvcNAQkFMQ8XDTI2MTExMjE4MDYzOVowKAYJKoZIhvcNAQk0 +# MRswGTALBglghkgBZQMEAgGhCgYIKoZIzj0EAwIwLwYJKoZIhvcNAQkEMSIEINz7 +# N6YlS7egE4YX5RHrStSP6VmEfFZz9IH6i2EmFyW+MIHIBgsqhkiG9w0BCRACLzGB # uDCBtTCBsjCBrwQgV0/qF6r6XnxqK5sIyZixc15FCzhzykTmokygkw5j87AwgYow # dqR0MHIxCzAJBgNVBAYTAlVTMQ4wDAYDVQQIDAVUZXhhczEQMA4GA1UEBwwHSG91 # c3RvbjERMA8GA1UECgwIU1NMIENvcnAxLjAsBgNVBAMMJVNTTC5jb20gVGltZXN0 # YW1waW5nIElzc3VpbmcgUlNBIENBIDICEFRD+De9Wu4YAYRyuFzajuMwCgYIKoZI -# zj0EAwIERzBFAiAbA9Pk0619iAAeblzsxglMwhJTQrL6jChmcUWk4jpLDQIhAJ+P -# jbG9fb86dWEl76SqsrYYHe/vk6EIt8/CQbD0GN9A +# zj0EAwIESDBGAiEAkGk4P+zfcwoRwcXxPOCLCOiWxh/zskK9IaTeh7yNkcQCIQDc +# mtjze0o5zfV28BSr5RQ7zJ26jia0DBXNw/SkCEvNNQ== # SIG # End signature block diff --git a/package/PraRemoteMailbox.psd1 b/package/PraRemoteMailbox.psd1 index ec60f47..2f36053 100644 --- a/package/PraRemoteMailbox.psd1 +++ b/package/PraRemoteMailbox.psd1 @@ -10,7 +10,7 @@ # What the root module (PraRemoteMailbox.psm1) loads: PRA.Common and PRA.Directory (which loads PRA.Backup). The other # parts keep their on-demand import, on purpose: # - module\PRA.Cloud.psm1 is imported only when the cloud phase needs it (in the dedicated process the Microsoft Graph -# modules load before ExchangeOnlineManagement, which avoids assembly conflicts); +# modules load before ExchangeOnlineManagement); # - module\PRA.Gui.psm1 is imported only for -Gui. # A manifest cannot express a conditional load order, so those two are not NestedModules. # @@ -19,7 +19,7 @@ # @{ RootModule = 'PraRemoteMailbox.psm1' - ModuleVersion = '3.1.2' + ModuleVersion = '3.1.3' GUID = '1d97585b-d077-4d74-bf10-4e36d16308b6' Author = 'Nicolas Fabert' Description = 'PRA Remote Mailbox: disaster-recovery tool for an Exchange hybrid environment. Converts on-premises mailboxes to remote mailboxes and back (Active Directory and Exchange Online), with a backup before every write, a proof after it, a guided console and a transfer package between the Active Directory server and the cloud server.' @@ -37,7 +37,7 @@ # Private folders, phase data and transfer package (PRA.Common) 'New-PraPrivateDirectorySecurity', 'Initialize-PraPrivateFolder', 'Register-PraObjectName', 'Register-PraObjectBackup', 'Save-PraPhaseData', 'Copy-PraPhaseData', 'Get-PraTransferPackageName', 'Get-PraTransferPackage', 'New-PraTransferPackage', 'Import-PraTransferPackage', # Active Directory, backup and proof (PRA.Directory) - 'Initialize-PraDirectory', 'Initialize-PraPermissionCache', 'Get-PraUser', 'Get-PraExpectedX500', 'Get-PraTarget', 'New-PraRow', 'New-PraPlan', 'Invoke-PraAdPreview', 'Invoke-PraAdBatch', 'Invoke-PraAdReplication', 'Invoke-PraSync', 'Test-PraSyncServer', 'Start-PraSyncProbe', 'Import-PraBackup', 'Import-PraProof', 'Assert-PraReceipt', 'Assert-PraFollowupState', 'Get-PraHash', 'Write-PraImmutableFile', 'New-PraPrivateDirectory', 'Write-PraJournal' + 'Initialize-PraDirectory', 'Initialize-PraPermissionCache', 'Get-PraUser', 'Resolve-PraGroup', 'Get-PraGroupMember', 'Get-PraExpectedX500', 'Get-PraTarget', 'New-PraRow', 'New-PraPlan', 'Invoke-PraAdPreview', 'Invoke-PraAdBatch', 'Invoke-PraAdReplication', 'Invoke-PraSync', 'Test-PraSyncServer', 'Start-PraSyncProbe', 'Import-PraBackup', 'Import-PraProof', 'Assert-PraReceipt', 'Assert-PraFollowupState', 'Get-PraHash', 'Write-PraImmutableFile', 'New-PraPrivateDirectory', 'Write-PraJournal' ) CmdletsToExport = @() VariablesToExport = @() @@ -45,10 +45,10 @@ } # SIG # Begin signature block -# MIImKgYJKoZIhvcNAQcCoIImGzCCJhcCAQExDzANBglghkgBZQMEAgEFADB5Bgor +# MIImKQYJKoZIhvcNAQcCoIImGjCCJhYCAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG -# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCBPeNmY9GhDd24i -# x+4O7QAa8qeVff3ILBPTa24hsr62rKCCDW8wggZyMIIEWqADAgECAghkM1HTxzif +# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDELnEqL//4EJnl +# Q5t+eua7v+Rj6RgY44K0ycHyRAHEeKCCDW8wggZyMIIEWqADAgECAghkM1HTxzif # CDANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMx # EDAOBgNVBAcMB0hvdXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8G # A1UEAwwoU1NMLmNvbSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IFJTQTAe @@ -120,28 +120,28 @@ # ULeH38N0Vr83psiJVuBSxQyt5nRVrpYz7FACq5gtXELkyViq/rGOlJKaRrgQ6WWq # eoIXqKhVFAdP/jAEm2M8ezoVYsUgPyKY2OcuecV9coulAcxUIUydx6qYiOfsGj5u # Dy7l4aYjvB771wkUMzUQwxzcDYXJtMMTaWRe6n9EemR67jc73u5CJyFg3PfA5WR1 -# wZislcdCZuS6MYIYETCCGA0CAQEwgYwweDELMAkGA1UEBhMCVVMxDjAMBgNVBAgM +# wZislcdCZuS6MYIYEDCCGAwCAQEwgYwweDELMAkGA1UEBhMCVVMxDjAMBgNVBAgM # BVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMREwDwYDVQQKDAhTU0wgQ29ycDE0MDIG # A1UEAwwrU1NMLmNvbSBDb2RlIFNpZ25pbmcgSW50ZXJtZWRpYXRlIENBIFJTQSBS # MQIQBof4ljXihJpmCqqt2mhAWzANBglghkgBZQMEAgEFAKCBhDAYBgorBgEEAYI3 # AgEMMQowCKACgAChAoAAMBkGCSqGSIb3DQEJAzEMBgorBgEEAYI3AgEEMBwGCisG -# AQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMC8GCSqGSIb3DQEJBDEiBCDpy6tksovl -# 73O89hRJg92t3AqEju77NSGIS/TpSSGn0zANBgkqhkiG9w0BAQEFAASCAgAnVau+ -# rpAK71KMqDAASrzV/kp7Gfa/KWnxyEQMhLnulAcL80RLLKp6IE45N9CWByu4gK1G -# Edjl/P0vQrWSfvI2mfxcCCVDOTnutJb7XFwrBNKzQeWnufdXqDMWmxNHwgyNOWKU -# 4hiz+OLpeeSCUjmLIoyefn8/lQanX/p26dCt+vNaAjLarp8DA9ETACpfiyy+IttQ -# Wyrik3+XYUHD1dh5uKqy5Ua8bghDIRroiDVm9qqLgqZOiYeZw4XgJ/jNI0kanC65 -# eA69kdk+jf4jiqFyfFkvi6l09AnGaMaoDHU3BwXGRnZug+uBJnNkB6dBDjg5AbPO -# UQRbhvGuiIDjujlctYsWGeYhHAXWK6CtOC+d4ngYuAzetGwx9Ui+2hQ18cqlR8xa -# f4WzToU69OUX7QbaXlotP66V/AZXX5/Wtgbu+60asLvwA200E7QTTOf8t/aRYuuU -# d7NO/IaQgTpHHANegwn1Tn9yWbIfrpT68Cq6IbPei3/3nfMWE4o1obyTeuRhjKZx -# Vd6E8LQBNXjGgzTGkIuX2TURfacGM4yV0TshOvy7mV6sujepyX51+kKLeW2ZTGkp -# fT2Ti3/75ynVFA9Q3oQ77eLCXFqrw9VKpYKyxHVNtIAb7uHF9q1F7FU7/FbPjIPx -# KWncAwNab/ehhhJv1WWAP98F70vrhyOIzNXBR6GCFM4wghTKBgorBgEEAYI3AwMB -# MYIUujCCFLYGCSqGSIb3DQEHAqCCFKcwghSjAgEDMQ0wCwYJYIZIAWUDBAIBMIGJ +# AQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMC8GCSqGSIb3DQEJBDEiBCAqCENgn4t3 +# Ks/AFp3OckrOh6ZfWt70xf0A2P5rt0ZZ0zANBgkqhkiG9w0BAQEFAASCAgAW90Jw +# T6CU46jCIYjciTR7EjUcYQzs/kPyxyJehkDdDARcOSoXhDts271JdcVRFFh/igSM +# T8ONWD4cKzc5BGJsDEY1KtDh1+kALqPRXUJ8jLS7yeow0HhPxlw4XiH4vS/2G5YC +# V1B5ik25KUCxhPJxAUhF3vnFRq0QFScSqfHteCdzEj0N1Z1xwTynUBcmnkSE+m8x +# ykZMIqi9UizVbfXqbqTh8exqJP3E3YQHhLRlFGIaUpxJb3F0eF22kQ47jU3dKIUR +# Jgl+mycfAqZ1ISotnPrVq6yNnyy0XwTzvF2o/yBMsjnhovf8UPZ90pP4Z0eSUi03 +# jsKGPlDUXCXv09rRgDUH4wQNtv3N9fxZRm/ecP3LKVu+Y8k86WsM+jjyqOVb4Sy4 +# i38Y8haUGMic0yS0KCFz9kv04pc34PwGeq8crZOHDsoOPh3n9Bh8M+ehszko06VV +# 1F/jfXNu2Wk3uokPb1Xxp6Krk4tv0jiEN9XbCCLBCpreOKRLT/IXBTi53k/iq8PY +# Jztyu6D7qVwCbUiGXTMg1SUcD3qlJKg/7Tk+SK/OkE/GsDsgocdp2Ry8W9kZ+IgI +# WuyTUhSGlty3NcQQ8NDjoyFV+PHZ7kY0n8G4nRCPJL9WWXF86n3cpXK3rJrhW5dx +# nhuAL6WeGCWEcm4uqV/NVexQatg22XoUQs7GoKGCFM0wghTJBgorBgEEAYI3AwMB +# MYIUuTCCFLUGCSqGSIb3DQEHAqCCFKYwghSiAgEDMQ0wCwYJYIZIAWUDBAIBMIGJ # BgsqhkiG9w0BCRABBKB6BHgwdgIBAQYMKwYBBAGCqTABAwYBMDEwDQYJYIZIAWUD -# BAIBBQAEIJ2s3yNLTvTLq/R8fsaVA7WKJU8EXHpttTOyKqs0o3ElAghC+mP7rhAE -# KBgPMjAyNjExMTAwODM0MDdaMAMCAQECEGu9FwqeCo3Hfti22Blm9IKgghGnMIIE +# BAIBBQAEIGYGqVkaFhTqdeJHX6h1+QD/KSPDVA0OrtRJMoqCDoEmAgg0rdr68vQN +# xxgPMjAyNjExMTIxODAyMThaMAMCAQECEF2o34Yw818repvnMYevzHmgghGnMIIE # 8zCCAtugAwIBAgIQVEP4N71a7hgBhHK4XNqO4zANBgkqhkiG9w0BAQsFADByMQsw # CQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hvdXN0b24xETAP # BgNVBAoMCFNTTCBDb3JwMS4wLAYDVQQDDCVTU0wuY29tIFRpbWVzdGFtcGluZyBJ @@ -236,17 +236,17 @@ # rDMtXndUg3qhJL4pA3ZUlo7w5lM5ml+A7ijr/3Gk2v4QRoDeE2ShmTXdHgtqo8L/ # fT119mYcETycE2NYGRXsBl3N0rzDsHRr8P3TrprqhRrX04iS0P7eQ+lDxgS3yhGn # 3OzWGhDt9Gf2x1qe0/qdhFAVOkXxzMZz4Uat6xsAfzX0+/m8GEKW5Ojw/HY+kLvV -# wzSPOzGCAlYwggJSAgEBMIGGMHIxCzAJBgNVBAYTAlVTMQ4wDAYDVQQIDAVUZXhh +# wzSPOzGCAlUwggJRAgEBMIGGMHIxCzAJBgNVBAYTAlVTMQ4wDAYDVQQIDAVUZXhh # czEQMA4GA1UEBwwHSG91c3RvbjERMA8GA1UECgwIU1NMIENvcnAxLjAsBgNVBAMM # JVNTTC5jb20gVGltZXN0YW1waW5nIElzc3VpbmcgUlNBIENBIDICEFRD+De9Wu4Y # AYRyuFzajuMwCwYJYIZIAWUDBAIBoIIBYDAaBgkqhkiG9w0BCQMxDQYLKoZIhvcN -# AQkQAQQwHAYJKoZIhvcNAQkFMQ8XDTI2MTExMDA4MzQwN1owKAYJKoZIhvcNAQk0 -# MRswGTALBglghkgBZQMEAgGhCgYIKoZIzj0EAwIwLwYJKoZIhvcNAQkEMSIEIIny -# tsnQCW8siQG6aWjnMwrVlIfIjuYxEI749r99k6ITMIHIBgsqhkiG9w0BCRACLzGB +# AQkQAQQwHAYJKoZIhvcNAQkFMQ8XDTI2MTExMjE4MDIxOFowKAYJKoZIhvcNAQk0 +# MRswGTALBglghkgBZQMEAgGhCgYIKoZIzj0EAwIwLwYJKoZIhvcNAQkEMSIEIPNj +# GngqtXz4+Cq3P4JDBDc6wXZ6V71EAP3Wn1ymfqGOMIHIBgsqhkiG9w0BCRACLzGB # uDCBtTCBsjCBrwQgV0/qF6r6XnxqK5sIyZixc15FCzhzykTmokygkw5j87AwgYow # dqR0MHIxCzAJBgNVBAYTAlVTMQ4wDAYDVQQIDAVUZXhhczEQMA4GA1UEBwwHSG91 # c3RvbjERMA8GA1UECgwIU1NMIENvcnAxLjAsBgNVBAMMJVNTTC5jb20gVGltZXN0 # YW1waW5nIElzc3VpbmcgUlNBIENBIDICEFRD+De9Wu4YAYRyuFzajuMwCgYIKoZI -# zj0EAwIERzBFAiEAs/iaBWvSIg98juD0I69O4AjnavzAA67P2T0yRTpbQB4CIHf3 -# UFOit/GRIUrGnG5urBLREWi8ZGdWHjZs7TUIPQVU +# zj0EAwIERjBEAiARlk478sQus/gwJOsvSBE/KnejAAzzS0fw/ACMkUA8AQIgYOjo +# m6/06Wpi/L77K1fcDS0llZ6efDLseOXgsVsqLZ0= # SIG # End signature block diff --git a/package/PraRemoteMailbox.psm1 b/package/PraRemoteMailbox.psm1 index ebceff4..70164b9 100644 --- a/package/PraRemoteMailbox.psm1 +++ b/package/PraRemoteMailbox.psm1 @@ -18,7 +18,7 @@ .NOTES Author : Nicolas Fabert - Version : 3.1.2 + Version : 3.1.3 History : see CHANGELOG.md #> #Requires -Version 7.5 @@ -51,8 +51,8 @@ Import-Module (Join-Path $PSScriptRoot 'module\PRA.Directory.psm1') -Force -Erro # SIG # Begin signature block # MIImKwYJKoZIhvcNAQcCoIImHDCCJhgCAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG -# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCoPTUbKb+7vu1z -# kV2mXLgC5b1rTpoLG4LPj3Gv2QPSVKCCDW8wggZyMIIEWqADAgECAghkM1HTxzif +# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCfQUrKOhqf+l82 +# Tsd3/XyPrJBLoIY/WMXFERrOMNOMjaCCDW8wggZyMIIEWqADAgECAghkM1HTxzif # CDANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMx # EDAOBgNVBAcMB0hvdXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8G # A1UEAwwoU1NMLmNvbSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IFJTQTAe @@ -129,23 +129,23 @@ Import-Module (Join-Path $PSScriptRoot 'module\PRA.Directory.psm1') -Force -Erro # A1UEAwwrU1NMLmNvbSBDb2RlIFNpZ25pbmcgSW50ZXJtZWRpYXRlIENBIFJTQSBS # MQIQBof4ljXihJpmCqqt2mhAWzANBglghkgBZQMEAgEFAKCBhDAYBgorBgEEAYI3 # AgEMMQowCKACgAChAoAAMBkGCSqGSIb3DQEJAzEMBgorBgEEAYI3AgEEMBwGCisG -# AQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMC8GCSqGSIb3DQEJBDEiBCAIbG6BZKuq -# tjHAY/b7FujEBXlzppjiXzpiou7wwPxSojANBgkqhkiG9w0BAQEFAASCAgA385I+ -# oYNPFClYVhbx5q4DCMDJsjKzmHjqlah6zte/W0fsH6PF1N9Ltq51V9/3PnZVPbfC -# RnKo7UFs9Zm+tvFsZTTwCGjIfJwSEyTQlG/iZZdpAaqFvSdhwWlA6csC/8x15Gs7 -# V36zf4umgNQCdQFvZT7Ll5PEJd+CIxMOe2bBPBHf4vizCQuGX8pDMu4gpmi+EPEG -# 6VewnE6DS28XPYzL/LddPs4sGnf1AX+IwNlkd0yYVACoY2UuxxGTeV9dXtueDmQO -# pn9cQgK+bsqaRlGwWLaxp2gSpenHG9YcXLzZg407VpdKNVxE97O9As3nSKD+N9Bz -# Aqeq4/KTGi817XjgkAxhUzmoeAUKnTx2x1pYPFHFg+OFH71YlzrrxPjqt3ewVSnC -# 0Yvzzr/7gtQF/7qxIIKDsTSRLYpeWOlKG7+EegXt26M4vgJtiq1S9uBscETxlGyL -# p5mf9o3/1B372u8wI0+M+yTK0/oZgZflpOh2hfZmxuFy0A8p4Q1AxhEKvkTRf4KS -# RjQy5dj666H7e4aHoGFX5HY7IRZXFiBc0zBTEKh1yiga6mKZKzBMTVDORnKSPAWM -# 9lKuptqRXSEtS29yshXDb9pIDGUlm9ALl5XqW9jPJqkav2tPbhdSm+Is3Juzx9F1 -# vtT5gqHzcRM/EdAsnR3cqr1FY3m0fxM430il86GCFM8wghTLBgorBgEEAYI3AwMB +# AQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMC8GCSqGSIb3DQEJBDEiBCBe2WfXF+B4 +# 4bI+PxACjP392/VX141/2eXTsOOOFkC4ZDANBgkqhkiG9w0BAQEFAASCAgBX41g4 +# sKQllefThp1ryCmYDl4kC1cdF0cUaxks6/3CGLaVOQWbEPoOf4hYhsu2ECNe3blC +# qrmubckF3sESFoq0ZBqCS0jiayq7OZ0FrJ3JGhHaJWogNblu8oWup6/BXC5wh9Ky +# qLFOsdfbDAPl9GI7H2SjoxAA4yfMmhyVnwEO0hKc1PD5tGm+HGmNV0oeOZbDxe2K +# hbx6Pb/Pr5YvaJBkbekHhwhXFnoLfY2l3detziK5amqu9Op71qukTXzpQ6yERgV/ +# D+84qnGDwjnCEK/7RPI4sPCkT35WnK3wa3vy9WAbZ6EXihzx2QopSAXwjPKvPQiE +# 0NQOF1liWE//5X+VfAzF/8+6BCMKZyGWAYr9gnUx0oEQ9+bD8PKzyIgF8ly+SvRq +# Rhgk19aH4K9GlOF2g+kLIGNwYmhnryHpm+qendfK+PvD1KD90intPlBpYKhd+FxE +# vcvDqD0U7cmDXolQSsB2mXYr8mMJK0a4NjWaVI4ZnfITBlmWjOGAFBDXFnGdX8k1 +# jqPslFx4w7vnTLdLM55GHnLdGKAT14POWI2/y1EjZ9Q2kiunIgbyTs3THX3xIIX1 +# P7smwJFr+YU2dFEhMTZ7ZdLmf1141Ct9r7ujzeMZFbbnqY/FFW7Aj42nDjsemj0L +# e0T0PGzoKN+alXIamhLms4FYz3CK+wJo7uoqrqGCFM8wghTLBgorBgEEAYI3AwMB # MYIUuzCCFLcGCSqGSIb3DQEHAqCCFKgwghSkAgEDMQ0wCwYJYIZIAWUDBAIBMIGJ # BgsqhkiG9w0BCRABBKB6BHgwdgIBAQYMKwYBBAGCqTABAwYBMDEwDQYJYIZIAWUD -# BAIBBQAEIA7miuuyhweJHgpmKXNA2Fglq+mVtE+rIRxYodbON6iRAgh45bqVKxqg -# iRgPMjAyNjExMTAwODM0MTNaMAMCAQECEFnAlcHhjez7ZxbwqL9nzQKgghGnMIIE +# BAIBBQAEIMKJBDVlyEyy0iuJosn419zmy1oUWe6rDy1ag4ve5QJ4Agg2wz8CG2UE +# uxgPMjAyNjExMTIxODAyMjFaMAMCAQECED8ox0PjuwTRiv3ZZ5/yow2gghGnMIIE # 8zCCAtugAwIBAgIQVEP4N71a7hgBhHK4XNqO4zANBgkqhkiG9w0BAQsFADByMQsw # CQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hvdXN0b24xETAP # BgNVBAoMCFNTTCBDb3JwMS4wLAYDVQQDDCVTU0wuY29tIFRpbWVzdGFtcGluZyBJ @@ -244,13 +244,13 @@ Import-Module (Join-Path $PSScriptRoot 'module\PRA.Directory.psm1') -Force -Erro # czEQMA4GA1UEBwwHSG91c3RvbjERMA8GA1UECgwIU1NMIENvcnAxLjAsBgNVBAMM # JVNTTC5jb20gVGltZXN0YW1waW5nIElzc3VpbmcgUlNBIENBIDICEFRD+De9Wu4Y # AYRyuFzajuMwCwYJYIZIAWUDBAIBoIIBYDAaBgkqhkiG9w0BCQMxDQYLKoZIhvcN -# AQkQAQQwHAYJKoZIhvcNAQkFMQ8XDTI2MTExMDA4MzQxM1owKAYJKoZIhvcNAQk0 -# MRswGTALBglghkgBZQMEAgGhCgYIKoZIzj0EAwIwLwYJKoZIhvcNAQkEMSIEIMgm -# XcKQ/LS3RCvPd2/oh99RI5SohYblkg9Kijx0FxNwMIHIBgsqhkiG9w0BCRACLzGB +# AQkQAQQwHAYJKoZIhvcNAQkFMQ8XDTI2MTExMjE4MDIyMVowKAYJKoZIhvcNAQk0 +# MRswGTALBglghkgBZQMEAgGhCgYIKoZIzj0EAwIwLwYJKoZIhvcNAQkEMSIEIAKL +# babzeGoSaAtdXMhO7hU5zNtRoGSQ8R3+LN1fLf6BMIHIBgsqhkiG9w0BCRACLzGB # uDCBtTCBsjCBrwQgV0/qF6r6XnxqK5sIyZixc15FCzhzykTmokygkw5j87AwgYow # dqR0MHIxCzAJBgNVBAYTAlVTMQ4wDAYDVQQIDAVUZXhhczEQMA4GA1UEBwwHSG91 # c3RvbjERMA8GA1UECgwIU1NMIENvcnAxLjAsBgNVBAMMJVNTTC5jb20gVGltZXN0 # YW1waW5nIElzc3VpbmcgUlNBIENBIDICEFRD+De9Wu4YAYRyuFzajuMwCgYIKoZI -# zj0EAwIESDBGAiEAoO0ujFjGFaS08EqaY8oXbUm7WljNyfB3fOMKNFJkz+ACIQCc -# AvIXjah9FQjUzSHIEU97/PX9PV1NCRKVWIZCwZpLfg== +# zj0EAwIESDBGAiEA+ilW3MdkAY4PBblCOET2PzJx8mbXAJpQ2Z2mMjpSFF4CIQCf +# QBdfJXs+KK/r7kCKCzPvtL3OAGAuN3IADr/FE/0Ihg== # SIG # End signature block diff --git a/package/README.md b/package/README.md index 9667d82..00a9a7a 100644 --- a/package/README.md +++ b/package/README.md @@ -1,6 +1,6 @@ # PRA Remote Mailbox -When the on-premises Exchange servers are lost, gives every user a mailbox in Exchange Online and rolls everything back when Exchange is available again. PowerShell 7.5+ engine, optional WPF window. Author: Nicolas Fabert. Version 3.1.2. +When the on-premises Exchange servers are lost, gives every user a mailbox in Exchange Online and rolls everything back when Exchange is available again. PowerShell 7.5+ engine, optional WPF window. Author: Nicolas Fabert. Version 3.1.3. This folder contains everything needed to run the tool: `Invoke-PraRemoteMailbox.ps1`, its modules and WPF window, the configuration and CSV samples, the report template and the two guides (user guide and reference guide). Tests and build tools stay outside it, in the repository. diff --git a/package/config/PraRemoteMailbox.config.psd1 b/package/config/PraRemoteMailbox.config.psd1 index 08df2d4..1265d36 100644 --- a/package/config/PraRemoteMailbox.config.psd1 +++ b/package/config/PraRemoteMailbox.config.psd1 @@ -2,7 +2,7 @@ # PRA Remote Mailbox - configuration file # -------------------------------------------------------------------------- # Author : Nicolas Fabert -# Version : 3.1.2 +# Version : 3.1.3 # # This file is read by Invoke-PraRemoteMailbox.ps1. It is a PowerShell data # file: text between quotes, $true / $false, numbers, and @( ) for lists. @@ -120,7 +120,7 @@ # Entra Connect synchronisation after the AD changes (Apply). # Sync = $true : one cycle is run and the tool waits for its end before the cloud part. # On this server (ADSync module) or on Server through PowerShell remoting. - # Checked BEFORE any AD change. + # Checked before any AD change. # Sync = $false: the operator runs it (Start-ADSyncSyncCycle -PolicyType Delta). # --------------------------------------------------------------------- EntraConnect = @{ diff --git a/package/docs/PraRemoteMailbox-Guide.html b/package/docs/PraRemoteMailbox-Guide.html index 1760704..1edf365 100644 --- a/package/docs/PraRemoteMailbox-Guide.html +++ b/package/docs/PraRemoteMailbox-Guide.html @@ -184,9 +184,9 @@ main { padding: 0; max-width: none; } .section { break-inside: avoid-page; box-shadow: none; } .part { break-before: page; } } -