Az.storage sync.tiering policy (Azure#12383)

* Update Az.StorageSync.psd1

* Add Tiering properties

* addd tiering proerties

Author: ankushbindlish2

src/StorageSync/StorageSync/Common/Converters/ServerEndpointConverter.cs

@@ -58,7 +58,9 @@ protected override StorageSyncModels.ServerEndpoint Transform(PSServerEndpoint s
                 source.OfflineDataTransfer,
                 source.OfflineDataTransferStorageAccountResourceId,
                 source.OfflineDataTransferStorageAccountTenantId,
-                source.OfflineDataTransferShareName);
+                source.OfflineDataTransferShareName,
+                initialDownloadPolicy:source.InitialDownloadPolicy != null ? (StorageSyncModels.InitialDownloadPolicy)System.Enum.Parse(typeof(StorageSyncModels.InitialDownloadPolicy),source.InitialDownloadPolicy,ignoreCase:true): default(StorageSyncModels.InitialDownloadPolicy?),
+                localCacheMode: source.LocalCacheMode != null ? (StorageSyncModels.LocalCacheMode)System.Enum.Parse(typeof(StorageSyncModels.LocalCacheMode), source.LocalCacheMode, ignoreCase: true) : default(StorageSyncModels.LocalCacheMode?));
         }
 
         /// <summary>
@@ -90,7 +92,9 @@ protected override PSServerEndpoint Transform(StorageSyncModels.ServerEndpoint s
                 OfflineDataTransfer = source.OfflineDataTransfer,
                 OfflineDataTransferShareName = source.OfflineDataTransferShareName,
                 OfflineDataTransferStorageAccountResourceId = source.OfflineDataTransferStorageAccountResourceId,
-                OfflineDataTransferStorageAccountTenantId = source.OfflineDataTransferStorageAccountTenantId
+                OfflineDataTransferStorageAccountTenantId = source.OfflineDataTransferStorageAccountTenantId,
+                InitialDownloadPolicy= source.InitialDownloadPolicy.HasValue ? source.InitialDownloadPolicy.Value.ToString() : null,
+                LocalCacheMode=source.LocalCacheMode.HasValue ? source.LocalCacheMode.Value.ToString() : null
             };
         }
     }

src/StorageSync/StorageSync/Common/HelpMessages.cs

@@ -175,6 +175,14 @@ public class HelpMessages
         /// </summary>
         public const string OfflineDataTransferShareNameParameter = "Cloud Seeded Data File Share Uri Parameter.";
         /// <summary>
+        /// The initial download policy parameter.
+        /// </summary>
+        public const string InitialDownloadPolicyParameter = "Initial Download Policy Parameter.";
+        /// <summary>
+        /// The Local cache mode parameter.
+        /// </summary>
+        public const string LocalCacheModeParameter = "Local Cache Mode Parameter.";
+        /// <summary>
         /// The tier files older than days parameter
         /// </summary>
         public const string TierFilesOlderThanDaysParameter = "Tier Files Older Than Days Parameter.";

src/StorageSync/StorageSync/Models/PSServerEndpoint.cs

@@ -110,5 +110,17 @@ public class PSServerEndpoint : PSResourceBase
         /// </summary>
         /// <value>The offline data transfer storage account tenant identifier.</value>
         public string OfflineDataTransferStorageAccountTenantId { get; internal set; }
+
+        // <summary>
+        /// Gets or sets a value indicating the policy to use for the initial download sync.
+        /// </summary>
+        /// <value>The initial download policy.</value>
+        public string InitialDownloadPolicy { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value indicating the policy to use for regular download sync sessions.
+        /// </summary>
+        /// <value>The local cache mode.</value>
+        public string LocalCacheMode { get; set; }
     }
 }

src/StorageSync/StorageSync/Properties/StorageSyncResources.Designer.cs

@@ -282,4 +282,10 @@
   <data name="SetStorageSyncServiceActionMessage" xml:space="preserve">
     <value>Updating a Storage Sync Service</value>
   </data>
+  <data name="InvalidInitialDownloadPolicyErrorMessage" xml:space="preserve">
+    <value>InitialDownloadPolicy parameter has invalid value.</value>
+  </data>
+  <data name="InvalidLocalCacheModeErrorMessage" xml:space="preserve">
+    <value>LocalCacheMode parameter has invalid value.</value>
+  </data>
 </root>

src/StorageSync/StorageSync/Properties/StorageSyncResources.resx

@@ -20,10 +20,11 @@
 using Microsoft.Azure.Commands.StorageSync.Properties;
 using Microsoft.Azure.Management.Internal.Resources.Utilities.Models;
 using Microsoft.Azure.Management.StorageSync;
-using Microsoft.Azure.Management.StorageSync.Models;
+using StorageSyncModels = Microsoft.Azure.Management.StorageSync.Models;
 using Microsoft.WindowsAzure.Commands.Common.CustomAttributes;
 using Microsoft.WindowsAzure.Commands.Utilities.Common;
 using System.Management.Automation;
+using System;
 
 namespace Microsoft.Azure.Commands.StorageSync.Cmdlets
 {
@@ -191,6 +192,41 @@ public class NewServerEndpointCommand : StorageSyncClientCmdletBase
           HelpMessage = HelpMessages.OfflineDataTransferShareNameParameter)]
         public string OfflineDataTransferShareName { get; set; }
 
+        // <summary>
+        /// Gets or sets a value indicating the policy to use for the initial download sync.
+        /// </summary>
+        /// <value>The initial download policy.</value>
+        [Parameter(
+          Mandatory = false,
+          ValueFromPipelineByPropertyName = false,
+          HelpMessage = HelpMessages.InitialDownloadPolicyParameter)]
+        // #TODO : Update swagger to make them string constants
+        //[ValidateSet(StorageSyncModels.InitialDownloadPolicy.AvoidTieredFiles,
+        //    StorageSyncModels.InitialDownloadPolicy.NamespaceOnly,
+        //    StorageSyncModels.InitialDownloadPolicy.NamespaceThenModifiedFiles,
+        //    IgnoreCase = true)]
+        [ValidateSet("AvoidTieredFiles",
+            "NamespaceOnly",
+            "NamespaceThenModifiedFiles",
+            IgnoreCase = true)]
+        public string InitialDownloadPolicy { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value indicating the policy to use for regular download sync sessions.
+        /// </summary>
+        /// <value>The local cache mode.</value>
+        [Parameter(
+          Mandatory = false,
+          ValueFromPipelineByPropertyName = false,
+          HelpMessage = HelpMessages.LocalCacheModeParameter)]
+        //[ValidateSet(StorageSyncModels.LocalCacheMode.DownloadNewAndModifiedFiles,
+        //    StorageSyncModels.LocalCacheMode.UpdateLocallyCachedFiles,
+        //    IgnoreCase = true)]
+        [ValidateSet("DownloadNewAndModifiedFiles",
+            "UpdateLocallyCachedFiles",
+            IgnoreCase = true)]
+        public string LocalCacheMode { get; set; }
+
         /// <summary>
         /// Gets or sets as job.
         /// </summary>
@@ -230,7 +266,7 @@ public override void ExecuteCmdlet()
                     }
                 }
 
-                var createParameters = new ServerEndpointCreateParameters()
+                var createParameters = new StorageSyncModels.ServerEndpointCreateParameters()
                 {
                     CloudTiering = CloudTiering.ToBool() ? StorageSyncConstants.CloudTieringOn : StorageSyncConstants.CloudTieringOff,
                     VolumeFreeSpacePercent = VolumeFreeSpacePercent,
@@ -241,14 +277,34 @@ public override void ExecuteCmdlet()
                     OfflineDataTransferShareName = OfflineDataTransferShareName
                 };
 
+                StorageSyncModels.InitialDownloadPolicy initialDownloadPolicy;
+                if (this.IsParameterBound(c => c.InitialDownloadPolicy))
+                {
+                    if (!Enum.TryParse(InitialDownloadPolicy, true, out initialDownloadPolicy))
+                    {
+                        throw new PSArgumentException(StorageSyncResources.InvalidInitialDownloadPolicyErrorMessage);
+                    }
+                    createParameters.InitialDownloadPolicy = initialDownloadPolicy;
+                }
+
+                StorageSyncModels.LocalCacheMode localCacheMode;
+                if (this.IsParameterBound(c => c.LocalCacheMode))
+                {
+                    if (!Enum.TryParse(LocalCacheMode, true, out localCacheMode))
+                    {
+                        throw new PSArgumentException(StorageSyncResources.InvalidLocalCacheModeErrorMessage);
+                    }
+                    createParameters.LocalCacheMode = localCacheMode;
+                }
+
                 string resourceGroupName = ResourceGroupName ?? ParentObject?.ResourceGroupName ?? parentResourceIdentifier.ResourceGroupName;
                 string storageSyncServiceName = StorageSyncServiceName ?? ParentObject?.StorageSyncServiceName ?? parentResourceIdentifier.GetParentResourceName(StorageSyncConstants.StorageSyncServiceTypeName, 0);
                 string syncGroupName = SyncGroupName ?? ParentObject?.SyncGroupName ?? parentResourceIdentifier.ResourceName;
 
                 Target = string.Join("/", resourceGroupName, storageSyncServiceName, syncGroupName, Name);
                 if (ShouldProcess(Target, ActionMessage))
                 {
-                    ServerEndpoint resource = StorageSyncClientWrapper.StorageSyncManagementClient.ServerEndpoints.Create(
+                    StorageSyncModels.ServerEndpoint resource = StorageSyncClientWrapper.StorageSyncManagementClient.ServerEndpoints.Create(
                         resourceGroupName,
                         storageSyncServiceName,
                         syncGroupName,

src/StorageSync/StorageSync/ServerEndpoint/NewServerEndpointCommand.cs

@@ -23,6 +23,7 @@
 using Microsoft.Azure.Management.StorageSync.Models;
 using Microsoft.WindowsAzure.Commands.Common.CustomAttributes;
 using Microsoft.WindowsAzure.Commands.Utilities.Common;
+using System;
 using System.Management.Automation;
 using StorageSyncModels = Microsoft.Azure.Management.StorageSync.Models;
 
@@ -160,7 +161,23 @@ public class SetServerEndpointCommand : StorageSyncClientCmdletBase
           HelpMessage = HelpMessages.TierFilesOlderThanDaysParameter)]
         public int? TierFilesOlderThanDays { get; set; }
 
-         /// <summary>
+        /// <summary>
+        /// Gets or sets a value indicating the policy to use for regular download sync sessions.
+        /// </summary>
+        /// <value>The local cache mode.</value>
+        [Parameter(
+          Mandatory = false,
+          ValueFromPipelineByPropertyName = false,
+          HelpMessage = HelpMessages.LocalCacheModeParameter)]
+        //[ValidateSet(StorageSyncModels.LocalCacheMode.DownloadNewAndModifiedFiles,
+        //    StorageSyncModels.LocalCacheMode.UpdateLocallyCachedFiles,
+        //    IgnoreCase = true)]
+        [ValidateSet("DownloadNewAndModifiedFiles",
+            "UpdateLocallyCachedFiles",
+            IgnoreCase = true)]
+        public string LocalCacheMode { get; set; }
+
+        /// <summary>
         /// Gets or sets as job.
         /// </summary>
         /// <value>As job.</value>
@@ -243,6 +260,16 @@ public override void ExecuteCmdlet()
                     updateParameters.OfflineDataTransfer = OfflineDataTransfer.ToBool() ? StorageSyncConstants.OfflineDataTransferOn : StorageSyncConstants.OfflineDataTransferOff;
                 }
 
+                StorageSyncModels.LocalCacheMode localCacheMode;
+                if (this.IsParameterBound(c => c.LocalCacheMode))
+                {
+                    if (!Enum.TryParse(LocalCacheMode, true, out localCacheMode))
+                    {
+                        throw new PSArgumentException(StorageSyncResources.InvalidLocalCacheModeErrorMessage);
+                    }
+                    updateParameters.LocalCacheMode = localCacheMode;
+                }
+
                 Target = string.Join("/", resourceGroupName, storageSyncServiceName, parentResourceName, resourceName);
                 if (ShouldProcess(Target, ActionMessage))
                 {

src/StorageSync/StorageSync/ServerEndpoint/SetServerEndpointCommand.cs

@@ -17,23 +17,23 @@ This command creates a new server endpoint on a registered server. This enables
 New-AzStorageSyncServerEndpoint [-ResourceGroupName] <String> [-StorageSyncServiceName] <String>
  [-SyncGroupName] <String> -Name <String> -ServerResourceId <String> -ServerLocalPath <String> [-CloudTiering]
  [-VolumeFreeSpacePercent <Int32>] [-OfflineDataTransfer] [-TierFilesOlderThanDays <Int32>]
- [-OfflineDataTransferShareName <String>] [-AsJob] [-DefaultProfile <IAzureContextContainer>] [-WhatIf]
+ [-OfflineDataTransferShareName <String>] [InitialDownloadPolicy] [LocalCacheMode] [-AsJob] [-DefaultProfile <IAzureContextContainer>] [-WhatIf]
  [-Confirm] [<CommonParameters>]
 ```
 
 ### ObjectParameterSet
 ```
 New-AzStorageSyncServerEndpoint [-ParentObject] <PSSyncGroup> -Name <String> -ServerResourceId <String>
  -ServerLocalPath <String> [-CloudTiering] [-VolumeFreeSpacePercent <Int32>] [-OfflineDataTransfer]
- [-TierFilesOlderThanDays <Int32>] [-OfflineDataTransferShareName <String>] [-AsJob]
+ [-TierFilesOlderThanDays <Int32>] [-OfflineDataTransferShareName <String>] [InitialDownloadPolicy] [LocalCacheMode] [-AsJob]
  [-DefaultProfile <IAzureContextContainer>] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
 ### ParentStringParameterSet
 ```
 New-AzStorageSyncServerEndpoint [-ParentResourceId] <String> -Name <String> -ServerResourceId <String>
  -ServerLocalPath <String> [-CloudTiering] [-VolumeFreeSpacePercent <Int32>] [-OfflineDataTransfer]
- [-TierFilesOlderThanDays <Int32>] [-OfflineDataTransferShareName <String>] [-AsJob]
+ [-TierFilesOlderThanDays <Int32>] [-OfflineDataTransferShareName <String>] [InitialDownloadPolicy] [LocalCacheMode] [-AsJob]
  [-DefaultProfile <IAzureContextContainer>] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
@@ -142,6 +142,36 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -initialDownloadPolicy
+Local cache mode Parameter
+
+```yaml
+Type: System.String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -localCacheMode
+Local cache mode Parameter
+
+```yaml
+Type: System.String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -ParentObject
 SyncGroup Object, normally passed through the parameter.
 

src/StorageSync/StorageSync/help/New-AzStorageSyncServerEndpoint.md

@@ -16,21 +16,21 @@ This command allows for changes on the adjustable parameters of a server endpoin
 ```
 Set-AzStorageSyncServerEndpoint [-ResourceGroupName] <String> [-StorageSyncServiceName] <String>
  [-SyncGroupName] <String> [-Name] <String> [-CloudTiering] [-VolumeFreeSpacePercent <Int32>]
- [-OfflineDataTransfer] [-TierFilesOlderThanDays <Int32>] [-AsJob] [-DefaultProfile <IAzureContextContainer>]
+ [-OfflineDataTransfer] [-TierFilesOlderThanDays <Int32>] [LocalCacheMode] [-AsJob] [-DefaultProfile <IAzureContextContainer>]
  [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
 ### ResourceIdParameterSet
 ```
 Set-AzStorageSyncServerEndpoint [-ResourceId] <String> [-CloudTiering] [-VolumeFreeSpacePercent <Int32>]
- [-OfflineDataTransfer] [-TierFilesOlderThanDays <Int32>] [-AsJob] [-DefaultProfile <IAzureContextContainer>]
+ [-OfflineDataTransfer] [-TierFilesOlderThanDays <Int32>] [LocalCacheMode] [-AsJob] [-DefaultProfile <IAzureContextContainer>]
  [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
 ### ObjectParameterSet
 ```
 Set-AzStorageSyncServerEndpoint [-InputObject] <PSServerEndpoint> [-CloudTiering]
- [-VolumeFreeSpacePercent <Int32>] [-OfflineDataTransfer] [-TierFilesOlderThanDays <Int32>] [-AsJob]
+ [-VolumeFreeSpacePercent <Int32>] [-OfflineDataTransfer] [-TierFilesOlderThanDays <Int32>] [LocalCacheMode] [-AsJob]
  [-DefaultProfile <IAzureContextContainer>] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
@@ -138,6 +138,21 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -localCacheMode
+Local cache mode Parameter
+
+```yaml
+Type: System.String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -ResourceGroupName
 Resource Group Name.