Release v2.40.0

msp360 · Oct 5, 2022 · eb17b90 · eb17b90
1 parent 3fbb01d
commit eb17b90
Show file tree

Hide file tree

Showing 28 changed files with 106 additions and 42 deletions.
diff --git a/docs/api/edit-mbsapiadministrator.md b/docs/api/edit-mbsapiadministrator.md
diff --git a/docs/api/edit-mbsapicompany.md b/docs/api/edit-mbsapicompany.md
diff --git a/docs/api/edit-mbsapiuserbackupdestination.md b/docs/api/edit-mbsapiuserbackupdestination.md
diff --git a/docs/api/new-mbsapiadministrator.md b/docs/api/new-mbsapiadministrator.md
diff --git a/docs/api/new-mbsapiadministratorpermission.md b/docs/api/new-mbsapiadministratorpermission.md
diff --git a/docs/api/new-mbsapicompany.md b/docs/api/new-mbsapicompany.md
diff --git a/docs/api/remove-mbsapicompany.md b/docs/api/remove-mbsapicompany.md
diff --git a/docs/backup-agent/new-mbsnbfplanschedule.md b/docs/backup-agent/new-mbsnbfplanschedule.md
diff --git a/docs/tools/restart-mbsagentservice.md b/docs/tools/restart-mbsagentservice.md
diff --git a/docs/tools/start-mbsagentservice.md b/docs/tools/start-mbsagentservice.md
diff --git a/docs/tools/stop-mbsagentservice.md b/docs/tools/stop-mbsagentservice.md
diff --git a/msp360.psd1 b/msp360.psd1
@@ -6,7 +6,7 @@
 
     CompanyName = 'MSP360'
 
-    ModuleVersion = '2.24.0'
+    ModuleVersion = '2.40.0'
 
     # Use the New-Guid command to generate a GUID, and copy/paste into the next line
     GUID = '69079da4-a0de-426d-bece-ae139c8b5f1a'
@@ -48,24 +48,17 @@
 
             # What new features, bug fixes, or deprecated features, are part of this release?
             ReleaseNotes = @"
-- Critical bugfix:
-    - Cannot update MSP360 PowerShell Module to version 2.x from older versions (Error: Authenticode issuer ... of the new module 'msp360' with version '2.21.143' ... is not matching with the authenticode issuer ... of the previously-installed module 'msp360' with version '1.x')
 - New cmdlets:
-    - Install-CONAgent (https://mspbackups.com/AP/Help/powershell/cmdlets/connect-agent/install-conagent)
-    - Get-CONAgent (https://mspbackups.com/AP/Help/powershell/cmdlets/connect-agent/get-conagent)
-    - Remove-CONAgent (https://mspbackups.com/AP/Help/powershell/cmdlets/connect-agent/remove-conagent)
-    - Install-RMMAgent (https://mspbackups.com/AP/Help/powershell/cmdlets/rmm-agent/install-rmmagent)
-    - Get-RMMAgent (https://mspbackups.com/AP/Help/powershell/cmdlets/rmm-agent/get-rmmagent)
-    - Remove-RMMAgent (https://mspbackups.com/AP/Help/powershell/cmdlets/rmm-agent/remove-rmmagent)
+    - Start-MBSAgentService (https://mspbackups.com/AP/Help/powershell/cmdlets/tools/start-mbsagentservice)
+    - Restart-MBSAgentService (https://mspbackups.com/AP/Help/powershell/cmdlets/tools/restart-mbsagentservice)
+    - Stop-MBSAgentService (https://mspbackups.com/AP/Help/powershell/cmdlets/tools/stop-mbsagentservice)
 - Enhancement:
-    - Install-MSP360Module: -CleanInstall switch to remove all previous versions of the module before install or update to the latest or requested version
-    - New-MBSBackupPlan, New-MBSNBFIBBBackupPlan: added -KeepBitLocker, -KeepBitLockerEnableForVolume, and -KeepBitLockerDisableForVolume parameters
-    - Edit-MBSBackupPlan: added -KeepBitLockerEnableForVolume and -KeepBitLockerDisableForVolume parameters
-    - New-MBSNBFIBBBackupPlan: added 'FixedVolumes' value for -BackupVolumes parameter
-    - Get-MBSBackupPlan: added output of 'BackupOptions' for volumes in NBF Image-Based backup plans
-    - New-MBSBackupPlan, New-MBSNBFIBBBackupPlan: added -ExcludeItem parameter for Image-Based backup plans
-    - New-MBSBackupPlan: added -ExcludeFile and -ExcludeDirectory parameters for File-Level backup plans
-    - Edit-MBSBackupPlan: added -DisableExcludeFilesFolders switch to remove and disable exclusions for Image-Based backup plans
+    - New-MBSAPICompany, Get-MBSAPICompany, Edit-MBSAPICompany: added company backup destination ID parameter and output
+    - New-MBSAPIAdministrator, Get-MBSAPIAdministrator, Edit-MBSAPIAdministrator: added AccountType parameter and output (this value is intended for future RBAC)
+    - New-MBSAPIAdministratorPermission: added -ManageImmutability parameter
+    - New-MBSNBFPlanSchedule: removed -Once switch (once frequency not supported in NBF)
+    - New-MBSNBFPlanSchedule: added -RepeatInterval and -RepeatStartDate parameters (MBS Backup Agent 7.5 release)
+    - Test-MBSConnection: suppress warning messages if TCP test succeeded, but ICMP ping failed
 "@
         }
     }

diff --git a/private/Add-MBSAPIType.ps1 b/private/Add-MBSAPIType.ps1
@@ -51,6 +51,11 @@ namespace MBS.API
         public string Name;
         public long StorageLimit;
         public string LicenseSettings;
+        public MBS.API.CompanyDestination[] Destinations;
+    }
+
+    public class CompanyDestination {
+        public string DestinationId;
     }
 
     public class Build {
@@ -100,6 +105,7 @@ namespace MBS.API
         public DateTime DateCreated;
         public string[] Companies;
         public MBS.API.AccessToCompaniesMode AccessToCompaniesMode;
+        public MBS.API.AdministratorAccountType AccountType;
     }
 
     public class AdministratorPermission {
@@ -134,6 +140,7 @@ namespace MBS.API
         public MBS.API.AdministratorPermissionMode UsersCreateEdit;
         public MBS.API.AdministratorPermissionMode UsersDelete;
         public MBS.API.AdministratorPermissionMode ManageCompanies;
+        public MBS.API.AdministratorPermissionMode ManageImmutability;
     }
 
     public class Destination1 {
@@ -406,5 +413,12 @@ namespace MBS.API
         SpecifiedCompanies,
         AllCompanies
     }
+
+    public enum AdministratorAccountType
+    {
+        Undefined,
+        InternalAccount,
+        ExternalAccount
+    }
 }
 "@
diff --git a/private/Add-MBSCBBType.ps1 b/private/Add-MBSCBBType.ps1
@@ -192,13 +192,17 @@ namespace MBS.Agent.Plan
         public TimeSpan OccursFrom;
         public TimeSpan OccursTo;
         public TimeSpan OccursEvery;
+        public int RepeatInterval;
+        public DateTime RepeatStartDate;
     }
 
     public class NBFFullSchedule {
         public MBS.Agent.Plan.NBFScheduleFrequency Frequency;
         public int DayOfMonth;
         public System.DayOfWeek[] DayOfWeek;
         public Nullable<MBS.Agent.Plan.WeekNumber> WeekNumber;
+        public int RepeatInterval;
+        public DateTime RepeatStartDate;
     }
 
     public class RestorePlanCommonOption {
@@ -334,7 +338,6 @@ namespace MBS.Agent.Plan
 
     public enum NBFScheduleFrequency
     {
-        Once,
         Daily,
         Weekly,
         Monthly,

diff --git a/private/New-MBSNBFBackupPlan.ps1 b/private/New-MBSNBFBackupPlan.ps1
@@ -79,6 +79,20 @@ function New-MBSNBFBackupPlan {
                     }
                 }
             }
+            if ($Schedule.RepeatInterval) {
+                if ($CBBVersion -ge [version]"7.5.0.80") {
+                    $ScheduleCli += " -repeatEvery$prefix $($Schedule.RepeatInterval)"
+                } else {
+                    Write-Warning "Backup agent version is $CBBVersion. ""RepeatInterval"" parameter requires version 7.5.0.80 or higher. Ignoring RepeatInterval option"
+                }
+            }
+            if ($Schedule.RepeatStartDate) {
+                if ($CBBVersion -ge [version]"7.5.0.80") {
+                    $ScheduleCli += " -repeatStartDate$prefix ""$($Schedule.RepeatStartDate.ToString())"""
+                } else {
+                    Write-Warning "Backup agent version is $CBBVersion. ""RepeatStartDate"" parameter requires version 7.5.0.80 or higher. Ignoring RepeatStartDate option"
+                }
+            }
 
             return $Schedulecli
 

diff --git a/public/api/Edit-MBSAPIAdministrator.ps1 b/public/api/Edit-MBSAPIAdministrator.ps1
diff --git a/public/api/Edit-MBSAPICompany.ps1 b/public/api/Edit-MBSAPICompany.ps1
diff --git a/public/api/Edit-MBSAPIUserBackupDestination.ps1 b/public/api/Edit-MBSAPIUserBackupDestination.ps1
diff --git a/public/api/New-MBSAPIAdministrator.ps1 b/public/api/New-MBSAPIAdministrator.ps1
diff --git a/public/api/New-MBSAPIAdministratorPermission.ps1 b/public/api/New-MBSAPIAdministratorPermission.ps1
@@ -99,6 +99,9 @@ function New-MBSAPIAdministratorPermission {
     .PARAMETER ManageCompanies
     Allowed to Manage companies
 
+    .PARAMETER ManageImmutability
+    Allowed to Manage immutability
+
     .PARAMETER EnableUndefinedPermissions
     If set, all undefined permissions will be enabled (by default, undefined permissions are disabled)
     
@@ -226,6 +229,9 @@ function New-MBSAPIAdministratorPermission {
         [Parameter(Mandatory=$false, HelpMessage="Allowed to Manage companies")]
         [MBS.API.AdministratorPermissionMode]$ManageCompanies,
         #
+        [Parameter(Mandatory=$false, HelpMessage="Allowed to Manage immutability")]
+        [MBS.API.AdministratorPermissionMode]$ManageImmutability,
+        #
         [Parameter(Mandatory=$false, HelpMessage="If set, all undefined permissions will be enabled (by default, undefined permissions are disabled)")]
         [switch]$EnableUndefinedPermissions
     )
@@ -274,6 +280,7 @@ function New-MBSAPIAdministratorPermission {
         if($null -ne $UsersCreateEdit) {$AdministratorPermissions.UsersCreateEdit = $UsersCreateEdit}
         if($null -ne $UsersDelete) {$AdministratorPermissions.UsersDelete = $UsersDelete}
         if($null -ne $ManageCompanies) {$AdministratorPermissions.ManageCompanies = $ManageCompanies}
+        if($null -ne $ManageImmutability) {$AdministratorPermissions.ManageImmutability = $ManageImmutability}
 
         return $AdministratorPermissions
     }

diff --git a/public/api/New-MBSAPICompany.ps1 b/public/api/New-MBSAPICompany.ps1
diff --git a/public/api/Remove-MBSAPICompany.ps1 b/public/api/Remove-MBSAPICompany.ps1
diff --git a/public/cbb/New-MBSNBFBackupPlanCommonOption.ps1 b/public/cbb/New-MBSNBFBackupPlanCommonOption.ps1
@@ -184,7 +184,6 @@ function New-MBSNBFBackupPlanCommonOption {
         $BackupPlanOption = New-Object -TypeName MBS.Agent.Plan.NBFBackupPlanCommonOption
         $BackupPlanOption.SyncRepositoryBeforeRun = $SyncRepositoryBeforeRun
         $BackupPlanOption.UseServerSideEncryption = $UseServerSideEncryption
-        $BackupPlanOption.UseServerSideEncryption = $UseServerSideEncryption
         $BackupPlanOption.EncryptionAlgorithm = $EncryptionAlgorithm
         $BackupPlanOption.EncryptionPassword = $EncryptionPassword
         $BackupPlanOption.UseCompression = $UseCompression

Type	String
Required:	true
Position:	1
Default value:
Accept pipeline input:	true (ByPropertyName)
Accept wildcard characters:	false

Type	String[]
Required:	false
Position:	4
Default value:
Accept pipeline input:	true (ByPropertyName)
Accept wildcard characters:	false

Type	Boolean
Required:	false
Position:	5
Default value:	True
Accept pipeline input:	true (ByPropertyName)
Accept wildcard characters:	false

Type	SecureString
Required:	false
Position:	6
Default value:
Accept pipeline input:	true (ByPropertyName)
Accept wildcard characters:	false

Type	AdministratorPermission
Required:	true
Position:	8
Default value:
Accept pipeline input:	true (ByPropertyName)
Accept wildcard characters:	false

Type	AccessToCompaniesMode
Required:	false
Position:	9
Default value:	SpecifiedCompanies
Accept pipeline input:	true (ByPropertyName)
Accept wildcard characters:	false

Type	AdministratorAccountType
Required:	false
Position:	10
Default value:
Accept pipeline input:	false
Accept wildcard characters:	false

Type	AdministratorPermissionMode
Required:	false
Position:	1
Default value:
Accept pipeline input:	false
Accept wildcard characters:	false

Type	SwitchParameter
Required:	false
Position:	named
Default value:	False
Accept pipeline input:	false
Accept wildcard characters:	false

Type	DateTime
Required:	true
Position:	named
Default value:
Accept pipeline input:	false
Accept wildcard characters:	false