Update helpers with explanations & examples

src/Security/Security/help/Az.Security.md

@@ -18,7 +18,7 @@ Enforces the given rules on the NSG(s) listed in the request
 Add SQL vulnerability assessment baseline.
 
 ### [Confirm-AzSecurityAutomation](Confirm-AzSecurityAutomation.md)
-{{ Fill in the Synopsis }}
+Validates the security automation model before create or update. Any validation errors are returned to the client
 
 ### [Disable-AzIotSecurityAnalyticsAggregatedAlert](Disable-AzIotSecurityAnalyticsAggregatedAlert.md)
 Dismiss Iot aggregated alert
@@ -87,7 +87,7 @@ Gets security assessments and their results on a subscription
 Gets security assessments types and metadta in a subscription.
 
 ### [Get-AzSecurityAutomation](Get-AzSecurityAutomation.md)
-{{ Fill in the Synopsis }}
+Gets security automation(s)
 
 ### [Get-AzSecurityAutoProvisioningSetting](Get-AzSecurityAutoProvisioningSetting.md)
 Gets the security automatic provisioning settings
@@ -159,7 +159,22 @@ Create new recommendation configuration for iot security solution
 Create new user defined resources for iot security solution
 
 ### [New-AzSecurityAutomation](New-AzSecurityAutomation.md)
-{{ Fill in the Synopsis }}
+Creates new security automation
+
+### [New-AzSecurityAutomationActionObject](New-AzSecurityAutomationActionObject.md)
+Creates new security automation action object
+
+### [New-AzSecurityAutomationRuleObject](New-AzSecurityAutomationRuleObject.md)
+Creates new security automation rule object
+
+### [New-AzSecurityAutomationRuleSetObject](New-AzSecurityAutomationRuleSetObject.md)
+Creates new security automation rule set object
+
+### [New-AzSecurityAutomationScopeObject](New-AzSecurityAutomationScopeObject.md)
+Creates new security automation scope object
+
+### [New-AzSecurityAutomationSourceObject](New-AzSecurityAutomationSourceObject.md)
+Creates new security automation source object
 
 ### [Remove-AzDeviceSecurityGroup](Remove-AzDeviceSecurityGroup.md)
 Delete device security group
@@ -177,7 +192,7 @@ Deletes a security assessment result from a subscription.
 Deletes a security assessment metadata from a subscription.
 
 ### [Remove-AzSecurityAutomation](Remove-AzSecurityAutomation.md)
-{{ Fill in the Synopsis }}
+Deletes security automation
 
 ### [Remove-AzSecurityContact](Remove-AzSecurityContact.md)
 Deletes a security contact.

src/Security/Security/help/Confirm-AzSecurityAutomation.md

@@ -8,7 +8,7 @@ schema: 2.0.0
 # Confirm-AzSecurityAutomation
 
 ## SYNOPSIS
-{{ Fill in the Synopsis }}
+Validates the security automation model before create or update. Any validation errors are returned to the client
 
 ## SYNTAX
 
@@ -37,16 +37,16 @@ Confirm-AzSecurityAutomation [-Location <String>] [-Etag <String>] [-Tag <Hashta
 ```
 
 ## DESCRIPTION
-{{ Fill in the Description }}
+Validates the security automation model before create or update. Any validation errors are returned to the client
 
 ## EXAMPLES
 
 ### Example 1
 ```powershell
-PS C:\> {{ Add example code here }}
+PS C:\> Confirm-AzSecurityAutomation -Name 'SampleAutomation' -ResourceGroupName 'SampleResourceGroup' -Description 'Sample security automation' -Scope $scopes -Source $sources -Action $actions
 ```
 
-{{ Add example description here }}
+Validates that the creation of security automation named "SampleAutomation" under resource group named "SampleResourceGroup"
 
 ## PARAMETERS
 

src/Security/Security/help/Get-AzSecurityAutomation.md

@@ -8,7 +8,7 @@ schema: 2.0.0
 # Get-AzSecurityAutomation
 
 ## SYNOPSIS
-{{ Fill in the Synopsis }}
+Gets security automations
 
 ## SYNTAX
 
@@ -35,16 +35,16 @@ Get-AzSecurityAutomation -ResourceId <String> [-DefaultProfile <IAzureContextCon
 ```
 
 ## DESCRIPTION
-{{ Fill in the Description }}
+Gets security automations
 
 ## EXAMPLES
 
 ### Example 1
 ```powershell
-PS C:\> {{ Add example code here }}
+PS C:\> Get-AzSecurityAutomation
 ```
 
-{{ Add example description here }}
+Gets all security automations under the subscription
 
 ## PARAMETERS
 

src/Security/Security/help/New-AzSecurityAutomation.md

@@ -8,7 +8,7 @@ schema: 2.0.0
 # New-AzSecurityAutomation
 
 ## SYNOPSIS
-{{ Fill in the Synopsis }}
+Creates new security automation
 
 ## SYNTAX
 
@@ -37,16 +37,16 @@ New-AzSecurityAutomation [-Location <String>] [-Etag <String>] [-Tag <Hashtable>
 ```
 
 ## DESCRIPTION
-{{ Fill in the Description }}
+Creates new security automation
 
 ## EXAMPLES
 
 ### Example 1
 ```powershell
-PS C:\> {{ Add example code here }}
+PS C:\> New-AzSecurityAutomation -Name 'ampleAutomation' -ResourceGroupName 'SampleResourceGroup' -Description 'Sample security automation' -Scope $scopes -Source $sources -Action $actions
 ```
 
-{{ Add example description here }}
+Creates new security automation named "SampleAutomation" under resource group named "SampleResourceGroup"
 
 ## PARAMETERS
 

src/Security/Security/help/New-AzSecurityAutomationActionObject.md

@@ -8,7 +8,7 @@ schema: 2.0.0
 # New-AzSecurityAutomationActionObject
 
 ## SYNOPSIS
-{{ Fill in the Synopsis }}
+Creates new security automation action object
 
 ## SYNTAX
 
@@ -31,16 +31,30 @@ New-AzSecurityAutomationActionObject -WorkspaceResourceId <String> [-DefaultProf
 ```
 
 ## DESCRIPTION
-{{ Fill in the Description }}
+Creates new security automation action object
 
 ## EXAMPLES
 
 ### Example 1
 ```powershell
-PS C:\> {{ Add example code here }}
+PS C:\> New-AzSecurityAutomationActionObject -WorkspaceResourceId '/subscriptions/64ac75e7-15ff-4963-8c07-a16016505e0f/resourceGroups/sampleResourceGroup/providers/Microsoft.OperationalInsights/workspaces/surashed-test'
 ```
 
-{{ Add example description here }}
+Creates new security automation action with workspace type
+
+### Example 2
+```powershell
+PS C:\> New-AzSecurityAutomationActionObject -LogicAppResourceId '/subscriptions/03b601f1-7eca-4496-8f8d-355219eee254/resourceGroups/sampleResourceGroup/providers/Microsoft.Logic/workflows/LA' -Uri 'https://dummy.com/'
+```
+
+Creates new security automation action with logicApp type
+
+### Example 3
+```powershell
+PS C:\> New-AzSecurityAutomationActionObject -EventHubResourceId 'subscriptions/03b601f1-7eca-4496-8f8d-355219eee254/resourceGroups/sampleResourceGroup/providers/Microsoft.EventHub/namespaces/cus-wsp-fake-assessment/eventhubs/cus-wsp-fake-assessment' -ConnectionString 'Endpoint=sb://dummy/;SharedAccessKeyName=dummy;SharedAccessKey=dummy;EntityPath=dummy'
+```
+
+Creates new security automation action with even-hub type
 
 ## PARAMETERS
 

src/Security/Security/help/New-AzSecurityAutomationRuleObject.md

@@ -8,7 +8,7 @@ schema: 2.0.0
 # New-AzSecurityAutomationRuleObject
 
 ## SYNOPSIS
-{{ Fill in the Synopsis }}
+Creates security automation rule object
 
 ## SYNTAX
 
@@ -18,16 +18,16 @@ New-AzSecurityAutomationRuleObject -PropertyJPath <String> -Operator <String> -E
 ```
 
 ## DESCRIPTION
-{{ Fill in the Description }}
+Creates security automation rule object
 
 ## EXAMPLES
 
 ### Example 1
 ```powershell
-PS C:\> {{ Add example code here }}
+PS C:\> New-AzSecurityAutomationRuleObject -PropertyJPath 'properties.metadata.severity'  -PropertyType 'String' -Operator 'Equals'  -ExpectedValue 'High'
 ```
 
-{{ Add example description here }}
+Creates security automation rule object that filters messages that with "High" severity
 
 ## PARAMETERS
 

src/Security/Security/help/New-AzSecurityAutomationRuleSetObject.md

@@ -8,7 +8,7 @@ schema: 2.0.0
 # New-AzSecurityAutomationRuleSetObject
 
 ## SYNOPSIS
-{{ Fill in the Synopsis }}
+Creates security automation rule set object
 
 ## SYNTAX
 
@@ -18,16 +18,16 @@ New-AzSecurityAutomationRuleSetObject -Rules <PSSecurityAutomationTriggeringRule
 ```
 
 ## DESCRIPTION
-{{ Fill in the Description }}
+Creates security automation rule set object
 
 ## EXAMPLES
 
 ### Example 1
 ```powershell
-PS C:\> {{ Add example code here }}
+PS C:\> New-AzSecurityAutomationRuleSetObject -Rule $rule
 ```
 
-{{ Add example description here }}
+Creates security automation rule set object
 
 ## PARAMETERS
 

src/Security/Security/help/New-AzSecurityAutomationScopeObject.md

@@ -8,7 +8,7 @@ schema: 2.0.0
 # New-AzSecurityAutomationScopeObject
 
 ## SYNOPSIS
-{{ Fill in the Synopsis }}
+Creates security automation scope object
 
 ## SYNTAX
 
@@ -18,16 +18,16 @@ New-AzSecurityAutomationScopeObject -Description <String> -ScopePath <String>
 ```
 
 ## DESCRIPTION
-{{ Fill in the Description }}
+Creates security automation scope object
 
 ## EXAMPLES
 
 ### Example 1
 ```powershell
-PS C:\> {{ Add example code here }}
+PS C:\> New-AzSecurityAutomationScopeObject -Description 'Security assessments that relate to the resource group myResourceGroup within the subscription a5caac9c-5c04-49af-b3d0-e204f40345d5'  -ScopePath '/subscriptions/a5caac9c-5c04-49af-b3d0-e204f40345d5/resourceGroups/myResourceGroup'
 ```
 
-{{ Add example description here }}
+Creates security automation scope object
 
 ## PARAMETERS
 

src/Security/Security/help/New-AzSecurityAutomationSourceObject.md

@@ -8,7 +8,7 @@ schema: 2.0.0
 # New-AzSecurityAutomationSourceObject
 
 ## SYNOPSIS
-{{ Fill in the Synopsis }}
+Creates security automation source object
 
 ## SYNTAX
 
@@ -24,16 +24,16 @@ New-AzSecurityAutomationSourceObject -EventSource <String> -RuleSets <PSSecurity
 ```
 
 ## DESCRIPTION
-{{ Fill in the Description }}
+Creates security automation source object
 
 ## EXAMPLES
 
 ### Example 1
 ```powershell
-PS C:\> {{ Add example code here }}
+PS C:\> New-AzSecurityAutomationSourceObject -EventSource 'Assessments' -RuleSet $ruleSet
 ```
 
-{{ Add example description here }}
+Creates security automation source object
 
 ## PARAMETERS
 

src/Security/Security/help/Remove-AzSecurityAutomation.md

@@ -8,7 +8,7 @@ schema: 2.0.0
 # Remove-AzSecurityAutomation
 
 ## SYNOPSIS
-{{ Fill in the Synopsis }}
+Deletes security automation
 
 ## SYNTAX
 
@@ -31,16 +31,16 @@ Remove-AzSecurityAutomation -InputObject <PSSecurityAutomation> [-PassThru]
 ```
 
 ## DESCRIPTION
-{{ Fill in the Description }}
+Deletes security automation
 
 ## EXAMPLES
 
 ### Example 1
 ```powershell
-PS C:\> {{ Add example code here }}
+PS C:\> Remove-AzSecurityAutomation -ResourceGroupName 'sampleResourceGroup' -Name 'sampleAutomation'
 ```
 
-{{ Add example description here }}
+Deletes security automation named 'sampleAutomation' under resource group named 'sampleResourceGroup'
 
 ## PARAMETERS