exports/New-CVAlertDefinition.ps1


# ----------------------------------------------------------------------------------
# Code generated by Microsoft (R) AutoRest Code Generator (autorest: 3.10.2, generator: @autorest/powershell@4.0.708)
# Changes may cause incorrect behavior and will be lost if the code is regenerated.
# ----------------------------------------------------------------------------------

<#
.Synopsis
Create Alert Definitions
.Description
Create Alert Definitions
.Example
{{ Add code here }}
.Example
{{ Add code here }}
 
.Outputs
Commvault.Powershell.Models.IIdNameGuid
.Notes
COMPLEX PARAMETER PROPERTIES
 
To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.
 
ALERTTYPEPARAMSLIST <IAlertDefinitionsCriteriaParams[]>: .
  [ParamIndex <Int64?>]: Param order index
  [Type <Int64?>]: Input value type (default 0 = no input required)
  [Unit <Int64?>]: Unit of the criteria(For eg. :Hrs,min)
  [Value <Int64?>]: Value of the criteria (deefault 0 : if no value required)
 
ASSOCIATIONS <IAlertAssociationIdNameType1[]>: AlertDefinitionsAssociations
  [Id <Int64?>]: id of the associated entity
  [Name <String>]: name of the associated entity
  [ParentEntity1Id <Int64?>]: id of the associated entity
  [ParentEntity1Name <String>]: name of the associated entity
  [ParentEntity1Type <String>]:
  [ParentEntity2Id <Int64?>]: id of the associated entity
  [ParentEntity2Name <String>]: name of the associated entity
  [ParentEntity2Type <String>]:
  [ParentEntity3Id <Int64?>]: id of the associated entity
  [ParentEntity3Name <String>]: name of the associated entity
  [ParentEntity3Type <String>]:
  [ParentEntity4Id <Int64?>]: id of the associated entity
  [ParentEntity4Name <String>]: name of the associated entity
  [ParentEntity4Type <String>]:
  [Type <String>]:
 
EVENTCRITERIONDETAILCONDITIONS <IConditionDetails[]>: .
  Id <Int64>: Unique identifier for the condition column
  Name <String>: Name of the condition column
  Operation <String>: Operation type value for the condition column
  [AdvancedCriteria <List<String>>]: List of advanced criteria options
  [FromValue <String>]: First value associated with the column when the operation type is BETWEEN
  [ToValue <String>]: Second value associated with the column when the operation type is BETWEEN
  [Value <String>]: Value associated with the column
  [ValuesList <List<Int64>>]: List of the values associated with the column in case of multiple values selection
 
GLOBALCONFIGINFOCOMMCELLS <IGlobalConfigCommcellInfo[]>: List of Service CommCells where the global configuration should be applied
  [Guid <String>]:
  [Id <Int64?>]:
  [Name <String>]:
 
RECIPIENTBCC <IAlertTargetIdNameType1[]>: .
  [Id <Int64?>]:
  [Name <String>]:
  [Type <String>]:
 
RECIPIENTCC <IAlertTargetIdNameType1[]>: .
  [Id <Int64?>]:
  [Name <String>]:
  [Type <String>]:
 
RECIPIENTTO <IAlertTargetIdNameType1[]>: .
  [Id <Int64?>]:
  [Name <String>]:
  [Type <String>]:
 
TOKENRULEGROUPS <ITokenRuleGroup[]>: List of rule groups
  [Match <String>]:
  [Rules <List<ITokenRule>>]: List of rules
    [DateRangeFromDate <String>]: From date value in unix timestamp format
    [DateRangeTimeRange <List<ITimeRange>>]: Time range selection details
      [FromTime <String>]: From time value in unix timestamp format
      [ToTime <String>]: To time value in unix timestamp format
    [DateRangeToDate <String>]: To date value in unix timestamp format
    [MatchCondition <String>]:
    [RuleSecValue <String>]: Secondary value used for BETWEEN and NOT_BETWEEN matchCondition.
    [TimeRangeFromTime <String>]: From time value in unix timestamp format
    [TimeRangeToTime <String>]: To time value in unix timestamp format
    [TokenFormat <String>]:
    [TokenName <String>]: Name of the token.
    [Value <String>]: Value to be compared for the token
.Link
https://learn.microsoft.com/powershell/module/commvaultpowershell/new-cvalertdefinition
#>

function New-CVAlertDefinition {
[OutputType([Commvault.Powershell.Models.IIdNameGuid])]
[CmdletBinding(DefaultParameterSetName='CreateExpanded', PositionalBinding=$false, SupportsShouldProcess, ConfirmImpact='Medium')]
param(
    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # Allows adding to, overwriting and deleting existing recipients.
    # default is adding to existing recipients
    ${AlertTargetRecipientsOperationType},

    [Parameter()]
    [AllowEmptyCollection()]
    [Commvault.Powershell.Category('Body')]
    [System.String[]]
    # .
    ${AlertTargetSendAlertTo},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # Defines the category of the alert
    ${AlertTypeCategory},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # Defines the criteria of the alert
    ${AlertTypeCriteria},

    [Parameter()]
    [AllowEmptyCollection()]
    [Commvault.Powershell.Category('Body')]
    [Commvault.Powershell.Models.IAlertDefinitionsCriteriaParams[]]
    # .
    ${AlertTypeParamsList},

    [Parameter()]
    [AllowEmptyCollection()]
    [Commvault.Powershell.Category('Body')]
    [Commvault.Powershell.Models.IAlertAssociationIdNameType1[]]
    # AlertDefinitionsAssociations
    ${Associations},

    [Parameter()]
    [AllowEmptyCollection()]
    [Commvault.Powershell.Category('Body')]
    [Commvault.Powershell.Models.IConditionDetails[]]
    # .
    ${EventCriterionDetailConditions},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # Alert criteria name
    ${EventCriterionDetailCriteriaName},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.Int64]
    # Integer value for the operation type between conditions
    ${EventCriterionDetailOpBetweenConditions},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # Action that will be taken on the local entity that has the same name as the global entity that needs to be created
    ${GlobalConfigInfoActionOnLocalEntity},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.Management.Automation.SwitchParameter]
    # Decides whether the global configuration should be applied to all the Service commcells, including the newly created ones
    ${GlobalConfigInfoApplyOnAllCommCells},

    [Parameter()]
    [AllowEmptyCollection()]
    [Commvault.Powershell.Category('Body')]
    [Commvault.Powershell.Models.IGlobalConfigCommcellInfo[]]
    # List of Service CommCells where the global configuration should be applied
    ${GlobalConfigInfoCommcells},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # .
    ${GlobalConfigInfoName},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # The entity level at which the config has to be applied.
    ${GlobalConfigInfoScope},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # CommCellEntityCache filter query string using for filtering the scope
    ${GlobalConfigInfoScopeFilterQuery},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.Int64]
    # .
    ${LocaleId},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # .
    ${LocaleName},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # .
    ${Name},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.Int64]
    # Delayed time in seconds when the notification criteria value contains delayed flag
    ${NotificationCriterionDelayTime},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.Int64]
    # Persisting time in seconds when the notification criteria value contains repeated flag
    ${NotificationCriterionPersistTime},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.Int64]
    # Bit flag indicating notification criteria value.
    # 1 means immediate, 2 means repeated and 8 means delayed
    ${NotificationCriterionValue},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.Management.Automation.SwitchParameter]
    # Flag indicating the functionality to send individual notifications for each discovered virtual machine
    ${ProcessDiscoveredVMS},

    [Parameter()]
    [AllowEmptyCollection()]
    [Commvault.Powershell.Category('Body')]
    [Commvault.Powershell.Models.IAlertTargetIdNameType1[]]
    # .
    ${RecipientBcc},

    [Parameter()]
    [AllowEmptyCollection()]
    [Commvault.Powershell.Category('Body')]
    [Commvault.Powershell.Models.IAlertTargetIdNameType1[]]
    # .
    ${RecipientCc},

    [Parameter()]
    [AllowEmptyCollection()]
    [Commvault.Powershell.Category('Body')]
    [Commvault.Powershell.Models.IAlertTargetIdNameType1[]]
    # .
    ${RecipientTo},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.Int64]
    # id of the webhook to be associated with the alert definition.
    # Only needed incase of webhook notif selected.
    # To get a list of webhooks, use api GET Webhook
    ${RecipientWebHookId},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.Management.Automation.SwitchParameter]
    # Flag indicating the functionality to send individual notifications
    ${SendIndividualNotifications},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.Management.Automation.SwitchParameter]
    # Flag to indicate whether its a subscription based alert.
    ${SubscriptionBasedAlert},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # the message template for the console notification
    ${TemplateConsole},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # the message template for the email notification.
    # Contains both email subject as well as body
    ${TemplateEmail},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # the message template for the event viewer notification
    ${TemplateEventViewer},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # the message template for the webhook notification
    ${TemplateWebhook},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # the template for the workflow input entries values (empty value means the configured workflow does not need any inputs value)
    ${TemplateWorkflowInputDetails},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # .
    ${TokenMatch},

    [Parameter()]
    [AllowEmptyCollection()]
    [Commvault.Powershell.Category('Body')]
    [Commvault.Powershell.Models.ITokenRuleGroup[]]
    # List of rule groups
    ${TokenRuleGroups},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.Int64]
    # id of the client on which the workflow runs (zero value means it can run on any workflow engine)
    ${WorkflowClientId},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # name of the client on which the workflow runs (empty value means it can run on any workflow engine)
    ${WorkflowClientName},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.Int64]
    # id of the workflow which runs when the alert is triggered
    ${WorkflowId},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # name of the workflow which runs when the alert is triggered
    ${WorkflowName},

    [Parameter(DontShow)]
    [Commvault.Powershell.Category('Runtime')]
    [System.Management.Automation.SwitchParameter]
    # Wait for .NET debugger to attach
    ${Break},

    [Parameter(DontShow)]
    [ValidateNotNull()]
    [Commvault.Powershell.Category('Runtime')]
    [Commvault.Powershell.Runtime.SendAsyncStep[]]
    # SendAsync Pipeline Steps to be appended to the front of the pipeline
    ${HttpPipelineAppend},

    [Parameter(DontShow)]
    [ValidateNotNull()]
    [Commvault.Powershell.Category('Runtime')]
    [Commvault.Powershell.Runtime.SendAsyncStep[]]
    # SendAsync Pipeline Steps to be prepended to the front of the pipeline
    ${HttpPipelinePrepend},

    [Parameter()]
    [Commvault.Powershell.Category('Runtime')]
    [System.Management.Automation.SwitchParameter]
    # Returns true when the command succeeds
    ${PassThru},

    [Parameter(DontShow)]
    [Commvault.Powershell.Category('Runtime')]
    [System.Uri]
    # The URI for the proxy server to use
    ${Proxy},

    [Parameter(DontShow)]
    [ValidateNotNull()]
    [Commvault.Powershell.Category('Runtime')]
    [System.Management.Automation.PSCredential]
    # Credentials for a proxy server to use for the remote call
    ${ProxyCredential},

    [Parameter(DontShow)]
    [Commvault.Powershell.Category('Runtime')]
    [System.Management.Automation.SwitchParameter]
    # Use the default credentials for the proxy
    ${ProxyUseDefaultCredentials}
)

begin {
    try {
        $outBuffer = $null
        if ($PSBoundParameters.TryGetValue('OutBuffer', [ref]$outBuffer)) {
            $PSBoundParameters['OutBuffer'] = 1
        }
        $parameterSet = $PSCmdlet.ParameterSetName

        $mapping = @{
            CreateExpanded = 'CommvaultPowerShell.private\New-CVAlertDefinition_CreateExpanded';
        }
        $cmdInfo = Get-Command -Name $mapping[$parameterSet]
        [Commvault.Powershell.Runtime.MessageAttributeHelper]::ProcessCustomAttributesAtRuntime($cmdInfo, $MyInvocation, $parameterSet, $PSCmdlet)
        [Commvault.Powershell.Runtime.MessageAttributeHelper]::ProcessPreviewMessageAttributesAtRuntime($cmdInfo, $MyInvocation, $parameterSet, $PSCmdlet)
        $wrappedCmd = $ExecutionContext.InvokeCommand.GetCommand(($mapping[$parameterSet]), [System.Management.Automation.CommandTypes]::Cmdlet)
        $scriptCmd = {& $wrappedCmd @PSBoundParameters}
        $steppablePipeline = $scriptCmd.GetSteppablePipeline($MyInvocation.CommandOrigin)
        $steppablePipeline.Begin($PSCmdlet)
    } catch {

        throw
    }
}

process {
    try {
        $steppablePipeline.Process($_)
    } catch {

        throw
    }

}
end {
    try {
        $steppablePipeline.End()

    } catch {

        throw
    }
} 
}