# New-RASNotificationEvent ## NAME New-RASNotificationEvent ## SYNOPSIS Creates new event notification. ## SYNTAX **New-RASNotificationEvent** \[-[Type](#Type)] {Agent | VDI | PubItem | License | Authentication | Tenant | FailedTunneledSess} \[[AllServers](#allservers-string) *(bool)*] \[[EnableGracePeriod](#enablegraceperiod-string) *(bool)*] \[[EnableInterval](#enableinterval-string) *(SwitchParameter)*] \[[ExecuteScript](#executescript-string) *(SwitchParameter)*] \[[GracePeriod](#graceperiod-string) *(uint)*] \[[Interval](#interval-string) *(uint)*] \[-[Recipients](#Recipients) *(string\[])*] \[[ScriptId](#scriptid-string) *(uint)*] \[-[ScriptObject](#ScriptObject) *(*[*NotificationScript*](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/notificationscript)*)*] \[[SendEmail](#sendemail-string) *(bool)*] \[[SiteId](#siteid-string) *(uint)*] \[-[TargetIds](#TargetIds) *(List\`1)*] \[-[TargetType](#TargetType) {AllServers | RDSHostPools | RDSHGroups | VDIHostPools | VDIPools | AVDHostPools | RemotePCs | SecureGateways | Gateways | Brokers | PublishingAgents | EnrollmentServers | ForceAllAgents}] \[[WaitUntilRecovered](#waituntilrecovered-string) *(SwitchParameter)*] \[*(*[*CommonParameters*](#CommonParameters)*)*] ## DESCRIPTION Creates notifications for events such as license activation, agent disconect/connect etc. ## PARAMETERS ## Type ([RASNotificationEventType](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/rasnotificationeventtype)) Notification type. Possible values: Agent, VDI, PubItem, License, Authentication, Tenant, FailedTunneledSess ``` Required? true Position? 0 Default value 0 Accept pipeline input? false Accept wildcard characters? false ``` ## SiteId (uint) Site ID where notification event is setup. Current site ID is used if siteId is omitted. ``` Required? false Position? named Default value 0 Accept pipeline input? false Accept wildcard characters? false ``` ## GracePeriod (uint) Grace period after the notification was done (minutes). ``` Required? false Position? named Default value 5 Accept pipeline input? false Accept wildcard characters? false ``` ## EnableGracePeriod (bool) Enable/Disable grace period. ``` Required? false Position? named Default value True Accept pipeline input? false Accept wildcard characters? false ``` ## Recipients (string\[]) Recipients to notify of the event. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## SendEmail (bool) Enable/Disable email notification. ``` Required? false Position? named Default value True Accept pipeline input? false Accept wildcard characters? false ``` ## ScriptId (uint) Script to execute which has this ID. ``` Required? false Position? named Default value 4294967295 Accept pipeline input? false Accept wildcard characters? false ``` ## ScriptObject ([NotificationScript](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/notificationscript)) Script Object. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## ExecuteScript (SwitchParameter) ``` Required? false Position? named Default value False Accept pipeline input? false Accept wildcard characters? false ``` ## Interval (uint) Invocation interval (minutes). ``` Required? false Position? named Default value 10 Accept pipeline input? false Accept wildcard characters? false ``` ## EnableInterval (SwitchParameter) Enable/Disable notification intervals. ``` Required? false Position? named Default value False Accept pipeline input? false Accept wildcard characters? false ``` ## WaitUntilRecovered (SwitchParameter) Wait until recovered. ``` Required? false Position? named Default value False Accept pipeline input? false Accept wildcard characters? false ``` ## AllServers (bool) All servers in site. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## TargetType ([TargetType](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/targettype)) Target type. Possible values: AllServers, RDSHostPools, RDSHGroups, VDIHostPools, VDIPools, AVDHostPools, RemotePCs, SecureGateways, Gateways, Brokers, PublishingAgents, EnrollmentServers, ForceAllAgents ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` ## TargetIds (List\`1) Target Ids. ``` Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` (CommonParameters) ``` This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters documentation. ``` ## INPUTS -none- ## OUTPUTS [NotificationEvent](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/notificationevent) [NotificationEventCriteria](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/notificationeventcriteria) ## EXAMPLES **---------- EXAMPLE 1 ----------** New-RASNotificationEvent -Type Agent Creates a new notification for agent events. ## RELATED LINKS * [Get-RASNotificationEvent](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/commands/get-rasnotificationevent) * [Set-RASNotificationEvent](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/commands/set-rasnotificationevent) * [Remove-RASNotificationEvent](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/commands/remove-rasnotificationevent)