Adding detailed description of cmdlets and parameters in help file.

Author: avneeshraiusit

src/ResourceManager/RecoveryServices.SiteRecovery/Commands.RecoveryServices.SiteRecovery/Fabrics/NewAzureRmRecoveryServicesAsrFabric.cs

@@ -48,15 +48,6 @@ public class NewAzureRmRecoveryServicesAsrFabric : SiteRecoveryCmdletBase
         [ValidateSet(Constants.HyperVSite)]
         public string Type { get; set; }
 
-        /// <summary>
-        ///     Gets or Sets the location
-        /// </summary>
-        [Parameter(
-            ParameterSetName = ASRParameterSets.Default,
-            Mandatory = false)]
-        [ValidateNotNullOrEmpty]
-        public string Location { get; set; }
-
         /// <summary>
         ///     ProcessRecord of the command.
         /// </summary>
@@ -70,15 +61,7 @@ public override void ExecuteSiteRecoveryCmdlet()
             var input = new FabricCreationInput();
             input.Properties = new FabricCreationInputProperties();
 
-            if (string.IsNullOrEmpty(this.Location))
-            {
-                input.Properties.CustomDetails = new FabricSpecificCreationInput();
-            }
-            else
-            {
-                input.Properties.CustomDetails =
-                    new AzureFabricCreationInput { Location = this.Location };
-            }
+            input.Properties.CustomDetails = new FabricSpecificCreationInput();
 
             var response = this.RecoveryServicesClient.CreateAzureSiteRecoveryFabric(
                 this.Name,

src/ResourceManager/RecoveryServices.SiteRecovery/Commands.RecoveryServices.SiteRecovery/help/Edit-AzureRmRecoveryServicesAsrRecoveryPlan.md

@@ -49,7 +49,7 @@ Appends a group to existing Azure Site Recovery recovery plan and returns the in
 ## PARAMETERS
 
 ### -AddProtectedItems
-Protected items to be added or removed.
+List of ASR replication protected items to be added to the recovery plan group in the recovery plan object.
 
 ```yaml
 Type: ASRReplicationProtectedItem[]
@@ -64,7 +64,7 @@ Accept wildcard characters: False
 ```
 
 ### -AppendGroup
-Indicates that this operation appends the group to the recovery plan object.
+Switch parameter to append a recovery plan group to the recovery plan object.
 
 ```yaml
 Type: SwitchParameter
@@ -79,7 +79,7 @@ Accept wildcard characters: False
 ```
 
 ### -Group
-Specifies a Site Recovery plan group.
+Specifies a recovery plan group.
 
 ```yaml
 Type: ASRRecoveryPlanGroup
@@ -94,7 +94,7 @@ Accept wildcard characters: False
 ```
 
 ### -InputObject
-{{Fill InputObject Description}}
+The ASR recovery plan object to be edited (In memory operation. To update the recovery plan run Update-AzureRmASRRecoveryPlan with the edited recovery plan object.)
 
 ```yaml
 Type: ASRRecoveryPlan
@@ -109,7 +109,7 @@ Accept wildcard characters: False
 ```
 
 ### -RemoveGroup
-Removes the specified Site Recovery recovery plan group.
+Removes the specified group from the recovery plan object.
 
 ```yaml
 Type: ASRRecoveryPlanGroup
@@ -124,7 +124,7 @@ Accept wildcard characters: False
 ```
 
 ### -RemoveProtectedItems
-{{Fill RemoveProtectedItems Description}}
+List of ASR replication protected items to be removed from the recovery plan group in the recovery plan object.
 
 ```yaml
 Type: ASRReplicationProtectedItem[]

src/ResourceManager/RecoveryServices.SiteRecovery/Commands.RecoveryServices.SiteRecovery/help/Get-AzureRmRecoveryServicesAsrFabric.md

@@ -7,7 +7,7 @@ schema: 2.0.0
 # Get-AzureRmRecoveryServicesAsrFabric
 
 ## SYNOPSIS
-Get the properties of an Azure Site Recovery Fabric.
+Get the details of an Azure Site Recovery Fabric.
 
 ## SYNTAX
 
@@ -36,12 +36,12 @@ The **Get-AzureRmRecoveryServicesAsrFabric** cmdlet gets the properties of a spe
 PS C:\> $fabrics = Get-AzureRmRecoveryServicesAsrFabric
 ```
 
-Returns all the Azure Site Recovery fabrics.
+Returns all the Azure Site Recovery fabrics in the vault.
 
 ## PARAMETERS
 
 ### -FriendlyName
-Specifies the friendly name of the Azure Site Recovery Fabric.
+Search for the ASR fabric by the friendly name of the fabric.
 
 ```yaml
 Type: String
@@ -56,7 +56,7 @@ Accept wildcard characters: False
 ```
 
 ### -Name
-Specifies the name of the Azure Site Recovery Fabric.
+Search for the ASR fabric by the name of the fabric.
 
 ```yaml
 Type: String

src/ResourceManager/RecoveryServices.SiteRecovery/Commands.RecoveryServices.SiteRecovery/help/Get-AzureRmRecoveryServicesAsrJob.md

@@ -7,7 +7,7 @@ schema: 2.0.0
 # Get-AzureRmRecoveryServicesAsrJob
 
 ## SYNOPSIS
-Gets the operation information for the current Site Recovery vault.
+Gets the details of the specified ASR job or the list of recent ASR jobs in the Recovery Services vault.
 
 ## SYNTAX
 
@@ -29,7 +29,7 @@ Get-AzureRmRecoveryServicesAsrJob -Job <ASRJob> [<CommonParameters>]
 
 ## DESCRIPTION
 The **Get-AzureRmRecoveryServicesAsrJob** cmdlet gets Azure Site Recovery jobs.
-You can use this cmdlet to view the operation information for the current Site Recovery vault.
+You can use this cmdlet to view the ASR jobs in the Recovery Services vault.
 
 ## EXAMPLES
 
@@ -38,7 +38,7 @@ You can use this cmdlet to view the operation information for the current Site R
 PS C:\> $jobs = Get-AzureRmRecoveryServicesAsrJob -TargetObjectId $ASRObjectId
 ```
 
-Returns all the jobs specific to a particular target ASR object Id.
+Returns all the jobs on a particular ASR object(reference the ASR object such as replicated item or recovery plan by its ID.) 
 
 ## PARAMETERS
 
@@ -61,7 +61,7 @@ Accept wildcard characters: False
 ```
 
 ### -Job
-Specifies the Site Recovery job.
+Specifies the ASR job object to get updated details for.
 
 ```yaml
 Type: ASRJob
@@ -76,7 +76,7 @@ Accept wildcard characters: False
 ```
 
 ### -Name
-Specifies a unique name that identifies the job.
+Specify the ASR job by name.
 
 ```yaml
 Type: String
@@ -107,7 +107,7 @@ Accept wildcard characters: False
 ```
 
 ### -State
-Specifies the input state for a Site Recovery job.
+Specifies the state for a ASR job.
 This cmdlet gets all jobs that match the specified state.
 The acceptable values for this parameter are:
 
@@ -133,7 +133,7 @@ Accept wildcard characters: False
 ```
 
 ### -TargetObjectId
-Specifies the ID of the object targeted by the job.
+Specifies the ID of the object. Used to search for jobs on the specified object.
 
 ```yaml
 Type: String

src/ResourceManager/RecoveryServices.SiteRecovery/Commands.RecoveryServices.SiteRecovery/help/Get-AzureRmRecoveryServicesAsrNetwork.md

@@ -36,12 +36,12 @@ The **Get-AzureRmRecoveryServicesAsrNetwork** cmdlet gets information about Azur
 PS C:\> $Networks = Get-AzureRmRecoveryServicesAsrNetwork -Fabric $Fabric
 ```
 
-Gets all networks in passed fabric.
+Gets all known networks in the specified fabric.
 
 ## PARAMETERS
 
 ### -Fabric
-Fabric object
+ASR fabric object
 
 ```yaml
 Type: ASRFabric
@@ -56,7 +56,7 @@ Accept wildcard characters: False
 ```
 
 ### -FriendlyName
-Friendly name of network.
+Friendly name of network ASR object.
 
 ```yaml
 Type: String
@@ -71,7 +71,7 @@ Accept wildcard characters: False
 ```
 
 ### -Name
-Name of object.
+Name of network ASR object.
 
 ```yaml
 Type: String

src/ResourceManager/RecoveryServices.SiteRecovery/Commands.RecoveryServices.SiteRecovery/help/Get-AzureRmRecoveryServicesAsrNetworkMapping.md

@@ -22,7 +22,7 @@ Get-AzureRmRecoveryServicesAsrNetworkMapping -Name <String> -Network <ASRNetwork
 ```
 
 ## DESCRIPTION
-The **Get-AzureRmRecoveryServicesAsrNetworkMapping** cmdlet gets information about Azure Site Recovery network mappings for the current Site Recovery vault.
+The **Get-AzureRmRecoveryServicesAsrNetworkMapping** cmdlet gets information about Azure Site Recovery network mappings for the Recovery Services vault.
 
 ## EXAMPLES
 
@@ -36,7 +36,7 @@ Gets all networks mappings for the passed Network.
 ## PARAMETERS
 
 ### -Name
-{{Fill Name Description}}
+The name of the ASR network mapping object to get.
 
 ```yaml
 Type: String
@@ -51,7 +51,7 @@ Accept wildcard characters: False
 ```
 
 ### -Network
-{{Fill Network Description}}
+Get the ASR network mappings corresponding to the specified network ASR object.
 
 ```yaml
 Type: ASRNetwork
@@ -82,4 +82,4 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 [New-AzureRmRecoveryServicesAsrNetworkMapping](./New-AzureRmRecoveryServicesAsrNetworkMapping.md)
 
-[Remove-AzureRmRecoveryServicesAsrNetworkMapping](./Remove-AzureRmRecoveryServicesAsrNetworkMapping.md)
+[Remove-AzureRmRecoveryServicesAsrNetworkMapping](./Remove-AzureRmRecoveryServicesAsrNetworkMapping.md)

src/ResourceManager/RecoveryServices.SiteRecovery/Commands.RecoveryServices.SiteRecovery/help/Get-AzureRmRecoveryServicesAsrPolicy.md

@@ -7,7 +7,7 @@ schema: 2.0.0
 # Get-AzureRmRecoveryServicesAsrPolicy
 
 ## SYNOPSIS
-Gets Site Recovery protection policies.
+Gets ASR replication policies.
 
 ## SYNTAX
 
@@ -27,7 +27,7 @@ Get-AzureRmRecoveryServicesAsrPolicy -FriendlyName <String> [<CommonParameters>]
 ```
 
 ## DESCRIPTION
-The **Get-AzureRmRecoveryServicesAsrPolicy** cmdlet gets the list of configured Azure Site Recovery protection policies or a specific protection policy by name.
+The **Get-AzureRmRecoveryServicesAsrPolicy** cmdlet gets the list of configured Azure Site Recovery replication policies or a specific replication policy by name.
 
 ## EXAMPLES
 
@@ -36,12 +36,12 @@ The **Get-AzureRmRecoveryServicesAsrPolicy** cmdlet gets the list of configured
 PS C:\> $Policy = Get-AzureRmRecoveryServicesAsrPolicy -Name $PolicyName
 ```
 
-Retruns a policy with the passed name.
+Retruns the replication policy with the specified name.
 
 ## PARAMETERS
 
 ### -FriendlyName
-Specifies the friendly name of the Site Recovery replication policy.
+Specifies the friendly name of the ASR replication policy.
 
 ```yaml
 Type: String
@@ -56,7 +56,7 @@ Accept wildcard characters: False
 ```
 
 ### -Name
-Specifies the name of the Site Recovery replication policy.
+Specifies the name of the ASR replication policy.
 
 ```yaml
 Type: String

src/ResourceManager/RecoveryServices.SiteRecovery/Commands.RecoveryServices.SiteRecovery/help/Get-AzureRmRecoveryServicesAsrProtectableItem.md

@@ -7,7 +7,7 @@ schema: 2.0.0
 # Get-AzureRmRecoveryServicesAsrProtectableItem
 
 ## SYNOPSIS
-Get the protectable items in a Protection Container.
+Get the protectable items in an ASR protection container.
 
 ## SYNTAX
 
@@ -39,12 +39,12 @@ The **Get-AzureRmRecoveryServicesAsrProtectableItem** cmdlet gets the protectabl
 PS C:\> $ProtectableItems = Get-AzureRmRecoveryServicesAsrProtectableItem -ProtectionContainer $Container
 ```
 
-Gets all the protectable items in passed container.
+Gets all the protectable items in specified ASR protection container.
 
 ## PARAMETERS
 
 ### -FriendlyName
-Specifies the friendly name of the Azure Site Recovery protectable item.
+Specifies the friendly name of the ASR protectable item.
 
 ```yaml
 Type: String
@@ -59,7 +59,7 @@ Accept wildcard characters: False
 ```
 
 ### -Name
-Specifies the name of the Azure Site Recovery protectable item.
+Specifies the name of the ASR protectable item.
 
 ```yaml
 Type: String

src/ResourceManager/RecoveryServices.SiteRecovery/Commands.RecoveryServices.SiteRecovery/help/Get-AzureRmRecoveryServicesAsrProtectionContainer.md

@@ -7,7 +7,7 @@ schema: 2.0.0
 # Get-AzureRmRecoveryServicesAsrProtectionContainer
 
 ## SYNOPSIS
-Gets protection containers for the current Site Recovery vault.
+Gets ASR protection containers in the Recovery Services vault.
 
 ## SYNTAX
 
@@ -28,9 +28,9 @@ Get-AzureRmRecoveryServicesAsrProtectionContainer -FriendlyName <String> -Fabric
 ```
 
 ## DESCRIPTION
-The **Get-AzureRmRecoveryServicesAsrProtectionContainer** cmdlet gets protection containers for the current Azure Site Recovery vault.
-A protection container is a logical container for protected objects such as virtual machines.
-Protection policies define replication settings for protected items and can be associated with a protection container and applied to a protected entity.
+The **Get-AzureRmRecoveryServicesAsrProtectionContainer** cmdlet gets Azure Site Recovery protection containers in the Recovery Services vault.
+A protection container is a logical container for protectable(discovered) and protected objects such as virtual machines.
+Replication policies define replication settings for protected items and can be associated with a protection container and applied to a protectable item.
 
 ## EXAMPLES
 
@@ -39,12 +39,12 @@ Protection policies define replication settings for protected items and can be a
 PS C:\> $ProtectionContainers = Get-AzureRmRecoveryServicesAsrFabric | Get-AzureRmRecoveryServicesAsrProtectionContainer
 ```
 
-Gets all containers in all piped fabrics.
+Gets all the ASR protection containers in the specified ASR fabric (the pipeline input in the above example.)
 
 ## PARAMETERS
 
 ### -Fabric
-{{Fill Fabric Description}}
+Look for the protection container in the specified ASR fabric.
 
 ```yaml
 Type: ASRFabric
@@ -59,7 +59,7 @@ Accept wildcard characters: False
 ```
 
 ### -FriendlyName
-Specifies the friendly name of the protection container.
+Specifies the friendly name of the ASR protection container to look for.
 
 ```yaml
 Type: String
@@ -74,7 +74,7 @@ Accept wildcard characters: False
 ```
 
 ### -Name
-Specifies the name of the protection container.
+Specifies the name of the ASR protection container to look for.
 
 ```yaml
 Type: String