updated help files

Author: siddharth7

src/RecoveryServices/RecoveryServices.Backup/Cmdlets/Item/GetAzureRMRecoveryServicesBackupProtectableItem.cs

@@ -36,9 +36,9 @@ public class GetAzureRmRecoveryServicesBackupProtectableItem : RSBackupVaultCmdl
         internal const string FilterParamSet = "FilterParamSet";
         internal const string IdParamSet = "IdParamSet";
 
-        [Parameter(Mandatory = true, Position = 0, ParameterSetName = NoFilterParamSet,
+        [Parameter(Mandatory = false, Position = 0, ParameterSetName = NoFilterParamSet,
             HelpMessage = ParamHelpMsgs.Item.Container, ValueFromPipelineByPropertyName = true)]
-        [Parameter(Mandatory = true, Position = 0, ParameterSetName = FilterParamSet,
+        [Parameter(Mandatory = false, Position = 0, ParameterSetName = FilterParamSet,
             HelpMessage = ParamHelpMsgs.Item.Container, ValueFromPipelineByPropertyName = true)]
         [ValidateNotNullOrEmpty]
         public ContainerBase Container { get; set; }
@@ -74,9 +74,10 @@ public override void ExecuteCmdlet()
 
                 string backupManagementType = "";
                 string workloadType = "";
-                string containerName = "";
+                ODataQuery<BMSPOQueryObject> queryParam = null;
                 if (ParameterSetName == IdParamSet)
                 {
+                    string containerName = "";
                     Dictionary<UriEnums, string> keyValueDict = HelperUtils.ParseUri(ParentID);
                     containerName = HelperUtils.GetContainerUri(keyValueDict, ParentID);
                     if (containerName.Split(new string[] { ";" }, System.StringSplitOptions.None)[0].ToLower() == "vmappcontainer")
@@ -89,18 +90,37 @@ public override void ExecuteCmdlet()
                     {
                         workloadType = ServiceClientModel.WorkloadType.SQLDataBase;
                     }
+                    queryParam = new ODataQuery<BMSPOQueryObject>(
+                    q => q.BackupManagementType
+                     == backupManagementType &&
+                     q.WorkloadType == workloadType &&
+                     q.ContainerName == containerName);
                 }
                 else
                 {
-                    backupManagementType = Container.BackupManagementType.ToString();
-                    workloadType = ConversionUtils.GetServiceClientWorkloadType(WorkloadType.ToString());
-                    containerName = Container.Name;
+                    if(Container != null)
+                    {
+                        string containerName = "";
+                        backupManagementType = Container.BackupManagementType.ToString();
+                        workloadType = ConversionUtils.GetServiceClientWorkloadType(WorkloadType.ToString());
+                        containerName = Container.Name;
+                        queryParam = new ODataQuery<BMSPOQueryObject>(
+                        q => q.BackupManagementType
+                            == backupManagementType &&
+                            q.WorkloadType == workloadType &&
+                            q.ContainerName == containerName);
+                    }
+                    else
+                    {
+                        backupManagementType = "AzureWorkload";
+                        workloadType = ConversionUtils.GetServiceClientWorkloadType(WorkloadType.ToString());
+                        queryParam = new ODataQuery<BMSPOQueryObject>(
+                        q => q.BackupManagementType
+                         == backupManagementType &&
+                         q.WorkloadType == workloadType);
+                    }
                 }
-                ODataQuery<BMSPOQueryObject> queryParam = new ODataQuery<BMSPOQueryObject>(
-                q => q.BackupManagementType
-                     == backupManagementType &&
-                     q.WorkloadType == workloadType &&
-                     q.ContainerName == containerName);
+
 
                 WriteDebug("going to query service to get list of protectable items");
                 List<WorkloadProtectableItemResource> protectableItems =

src/RecoveryServices/RecoveryServices/help/Disable-AzRecoveryServicesBackupAutoProtection.md

@@ -25,7 +25,8 @@ The **Disable-AzRecoveryServicesBackupAutoProtection** cmdlet disables protectio
 
 ### Example 1
 ```
-PS C:\> Disable-AzRecoveryServicesAutoProtection -BackupManagementType “AzureWorkload” -WorkloadType “MSSQL” -InputItem <$ItemID> -VaultId $vault.ID
+PS C:\> $container = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVMAppContainer
+PS C:\> Get-AzRecoveryServicesBackupProtectableItem -Container $container -WorkloadType "MSSQL" -ItemType "SQLInstance" | Disable-AzRecoveryServicesBackupAutoProtection -BackupManagementType "AzureWorkload" -WorkloadType "MSSQL"
 ```
 
 The first cmdlet disables the Backup protection policy.

src/RecoveryServices/RecoveryServices/help/Enable-AzRecoveryServicesBackupAutoProtection.md

@@ -27,7 +27,8 @@ The **Enable-AzRecoveryServicesBackupAutoProtection** cmdlet sets Azure auto Bac
 ### Example 1
 ```
 PS C:\> $Pol = Get-AzRecoveryServicesBackupProtectionPolicy -Name "DefaultPolicy"
-PS C:\> Enable-AzRecoveryServicesAutoProtection -BackupManagementType "AzureWorkload" -WorkloadType "MSSQL" -InputItem <$Item> -Policy $Pol -VaultId $vault.ID
+PS C:\> $container = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVMAppContainer
+PS C:\> Get-AzRecoveryServicesBackupProtectableItem -Container $container -WorkloadType "MSSQL" -ItemType "SQLInstance" | Enable-AzRecoveryServicesBackupAutoProtection -BackupManagementType "AzureWorkload" -WorkloadType "MSSQL" -Policy $Pol
 ```
 
 The first cmdlet gets a default policy object, and then stores it in the $Pol variable.

src/RecoveryServices/RecoveryServices/help/Get-AzRecoveryServicesBackupProtectableItem.md

@@ -14,17 +14,23 @@ Get protectable items from a container.
 
 ### NoFilterParamSet (Default)
 ```
-Get-AzRecoveryServicesBackupProtectableItem [-Container] <ContainerBase> [-WorkloadType] <WorkloadType>
+Get-AzRecoveryServicesBackupProtectableItem [[-Container] <ContainerBase>] [-WorkloadType] <WorkloadType>
  [-VaultId <String>] [-DefaultProfile <IAzureContextContainer>] [<CommonParameters>]
 ```
 
 ### FilterParamSet
 ```
-Get-AzRecoveryServicesBackupProtectableItem [-Container] <ContainerBase> [-WorkloadType] <WorkloadType>
+Get-AzRecoveryServicesBackupProtectableItem [[-Container] <ContainerBase>] [-WorkloadType] <WorkloadType>
  [[-ItemType] <ProtectableItemType>] [-VaultId <String>] [-DefaultProfile <IAzureContextContainer>]
  [<CommonParameters>]
 ```
 
+### IdParamSet
+```
+Get-AzRecoveryServicesBackupProtectableItem [-ParentID] <String> [-VaultId <String>]
+ [-DefaultProfile <IAzureContextContainer>] [<CommonParameters>]
+```
+
 ## DESCRIPTION
 The **Get-AzRecoveryServicesBackupProtectableItem** cmdlet gets the protectable items in a container or a value in Azure Backup and the protection status of the items.
 A container that is registered to an Azure Recovery Services vault can have one or more items that can be protected.
@@ -34,7 +40,7 @@ A container that is registered to an Azure Recovery Services vault can have one
 ### Example 1
 ```
 PS C:\>$Container = Get-AzRecoveryServicesBackupContainer -ContainerType MSSQL -Status Registered
-PS C:\> $Item = Get-AzRecoveryServicesProtectableItem -Container $Container -ItemType “SQLDatabase” -VaultId $vault.ID
+PS C:\> $Item = Get-AzRecoveryServicesProtectableItem -Container $Container -ItemType "SQLDatabase" -VaultId $vault.ID
 ```
 
 The first command gets the container of type MSSQL, and then stores it in the $Container variable.
@@ -47,10 +53,10 @@ Container where the item resides
 
 ```yaml
 Type: Microsoft.Azure.Commands.RecoveryServices.Backup.Cmdlets.Models.ContainerBase
-Parameter Sets: (All)
+Parameter Sets: NoFilterParamSet, FilterParamSet
 Aliases:
 
-Required: True
+Required: False
 Position: 0
 Default value: None
 Accept pipeline input: True (ByPropertyName)
@@ -88,6 +94,21 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -ParentID
+Parent ID
+
+```yaml
+Type: System.String
+Parameter Sets: IdParamSet
+Aliases:
+
+Required: True
+Position: 0
+Default value: None
+Accept pipeline input: True (ByPropertyName)
+Accept wildcard characters: False
+```
+
 ### -VaultId
 ARM ID of the Recovery Services Vault.
 
@@ -108,7 +129,7 @@ Workload type of the resource (for example: AzureVM, WindowsServer, AzureFiles).
 
 ```yaml
 Type: Microsoft.Azure.Commands.RecoveryServices.Backup.Cmdlets.Models.WorkloadType
-Parameter Sets: (All)
+Parameter Sets: NoFilterParamSet, FilterParamSet
 Aliases:
 Accepted values: AzureVM, AzureSQLDatabase, AzureFiles, MSSQL
 

src/RecoveryServices/RecoveryServices/help/Get-AzRecoveryServicesBackupRecoveryLogChain.md

@@ -35,8 +35,7 @@ After an item has been backed up, an **AzRecoveryServicesBackupRecoveryLogChain*
 PS C:\> $StartDate = (Get-Date).AddDays(-7) 
 PS C:\> $EndDate = Get-Date 
 PS C:\> $Container = Get-AzRecoveryServicesBackupContainer -ContainerType AzureWorkload -Status Registered
-PS C:\> $BackupItem = Get-AzRecoveryServicesBackupItem -Container $Container -WorkloadType MSSQL 
-PS C:\> $RP = Get-AzRecoveryServicesBackupRecoveryLogChain -Item $BackupItem -StartDate $Startdate.ToUniversalTime() -EndDate $Enddate.ToUniversalTime()
+PS C:\> $RP = Get-AzRecoveryServicesBackupItem -Container $Container -WorkloadType MSSQL | Get-AzRecoveryServicesBackupRecoveryLogChain -StartDate $Startdate.ToUniversalTime() -EndDate $Enddate.ToUniversalTime()
 ```
 
 The first command gets the date from seven days ago, and then stores it in the $StartDate variable.

src/RecoveryServices/RecoveryServices/help/Get-AzRecoveryServicesBackupWorkloadRecoveryConfig.md

@@ -35,9 +35,8 @@ The command returns a recovery config for AzureWorkload items which is passed to
 
 ### Example 1
 ```
-PS C:\> $RP = Get-AzRecoveryServicesBackupRecoveryPoint -Item $SQLBkpItem $startdate $enddate
-PS C:\> $SQLRecoveryObject = Get-AzRecoveryServicesWorkloadRecoveryConfig -RecoveryPoint $RP -OriginalWorkloadRestore
-PS C:\> $SQLRecoveryObject = Get-AzRecoveryServicesWorkloadRecoveryConfig -RecoveryPoint $RP -AlternateWorkloadRestore -TargetItem $SQLProtItem
+PS C:\> $SQLRecoveryObject = Get-AzRecoveryServicesBackupRecoveryPoint -Item $SQLBkpItem $startdate $enddate | Get-AzRecoveryServicesWorkloadRecoveryConfig -OriginalWorkloadRestore
+PS C:\> $SQLRecoveryObject = Get-AzRecoveryServicesBackupRecoveryPoint -Item $SQLBkpItem $startdate $enddate | Get-AzRecoveryServicesWorkloadRecoveryConfig -AlternateWorkloadRestore -TargetItem $SQLProtItem
 ```
 
 The first cmdlet is used to get the Recovery point object.