From 63f7ed40528646ae3c073307b2bd8e07bac2df55 Mon Sep 17 00:00:00 2001 From: Ben Whitmore <44303264+byteben@users.noreply.github.com> Date: Wed, 22 Jul 2020 15:40:35 +0100 Subject: [PATCH 01/16] Update README.md --- README.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/README.md b/README.md index 9a68073..8b37b66 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,30 @@ # Toast +Toast_Notify.ps1 is a simple Toast Notification script designed to be deployed as a package from MEMCM +Toast_Notify.ps1 will read an XML file on a file share so Toast Notifications can be changed "on the fly" without having to repackage. +To create a custom XML, copy CustomMessage.xml and edit the text you want to display in the toast notification. Reference that file using one of the script parameters. + +The following files should be present in the Script Directory when you create the package in MEMCM:- + +Toast_Notify.ps1 +BadgeImage.jpg +HeroImage.jpg +CustomMessage.xml + +.PARAMETER XMLScriptDirSource +Specify the name of the XML file to read. The XML file must exist in the same directory as Toast_Notify.ps1. If no parameter is passed, it is assumed the XML file is called CustomMessage.xml. + +.PARAMETER XMLOtherSource +Specify the location of the Custom XML file used for the Toast when it is not in the MEMCM package + +.EXAMPLE +Toast_Notify.ps1 -XMLOtherSource "\\fileserverhome\xml\CustomMessage.xml" + +.EXAMPLE +Toast_Notify.ps1 -XMLSciptDirSource "PhoneSystemProblems.xml" + +.EXAMPLE +Toast_Notify.ps1 + +**Known Issues** +Currently, the images in the XML can only be read from the local files system. This is not an issue if we are deploying the package from MEMCM. Further development will see the ability to convert images to Base64 or host them on a web server From ad5204c097881e495e8fd7078164e833f07a6021 Mon Sep 17 00:00:00 2001 From: Ben Whitmore <44303264+byteben@users.noreply.github.com> Date: Wed, 22 Jul 2020 15:41:22 +0100 Subject: [PATCH 02/16] Update README.md --- README.md | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index 8b37b66..fd49be6 100644 --- a/README.md +++ b/README.md @@ -4,27 +4,27 @@ Toast_Notify.ps1 is a simple Toast Notification script designed to be deployed a Toast_Notify.ps1 will read an XML file on a file share so Toast Notifications can be changed "on the fly" without having to repackage. To create a custom XML, copy CustomMessage.xml and edit the text you want to display in the toast notification. Reference that file using one of the script parameters. -The following files should be present in the Script Directory when you create the package in MEMCM:- - +The following files should be present in the Script Directory when you create the package in MEMCM:- + Toast_Notify.ps1 BadgeImage.jpg HeroImage.jpg CustomMessage.xml - -.PARAMETER XMLScriptDirSource + +.PARAMETER XMLScriptDirSource Specify the name of the XML file to read. The XML file must exist in the same directory as Toast_Notify.ps1. If no parameter is passed, it is assumed the XML file is called CustomMessage.xml. - -.PARAMETER XMLOtherSource + +.PARAMETER XMLOtherSource Specify the location of the Custom XML file used for the Toast when it is not in the MEMCM package - -.EXAMPLE + +.EXAMPLE Toast_Notify.ps1 -XMLOtherSource "\\fileserverhome\xml\CustomMessage.xml" - -.EXAMPLE + +.EXAMPLE Toast_Notify.ps1 -XMLSciptDirSource "PhoneSystemProblems.xml" - -.EXAMPLE + +.EXAMPLE Toast_Notify.ps1 - -**Known Issues** + +**Known Issues** Currently, the images in the XML can only be read from the local files system. This is not an issue if we are deploying the package from MEMCM. Further development will see the ability to convert images to Base64 or host them on a web server From 02b316e8796f6d5afaae97299cd66b5ab32373b6 Mon Sep 17 00:00:00 2001 From: Ben Whitmore <44303264+byteben@users.noreply.github.com> Date: Wed, 22 Jul 2020 15:41:57 +0100 Subject: [PATCH 03/16] Update README.md --- README.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index fd49be6..6113499 100644 --- a/README.md +++ b/README.md @@ -5,12 +5,13 @@ Toast_Notify.ps1 will read an XML file on a file share so Toast Notifications ca To create a custom XML, copy CustomMessage.xml and edit the text you want to display in the toast notification. Reference that file using one of the script parameters. The following files should be present in the Script Directory when you create the package in MEMCM:- +** +Toast_Notify.ps1 +BadgeImage.jpg +HeroImage.jpg +CustomMessage.xml -Toast_Notify.ps1 -BadgeImage.jpg -HeroImage.jpg -CustomMessage.xml - +** .PARAMETER XMLScriptDirSource Specify the name of the XML file to read. The XML file must exist in the same directory as Toast_Notify.ps1. If no parameter is passed, it is assumed the XML file is called CustomMessage.xml. From f69da6c5bad6884956fb5b8e05b91bc46209eab0 Mon Sep 17 00:00:00 2001 From: Ben Whitmore <44303264+byteben@users.noreply.github.com> Date: Wed, 22 Jul 2020 15:42:29 +0100 Subject: [PATCH 04/16] Update README.md --- README.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 6113499..26b1b5d 100644 --- a/README.md +++ b/README.md @@ -5,13 +5,14 @@ Toast_Notify.ps1 will read an XML file on a file share so Toast Notifications ca To create a custom XML, copy CustomMessage.xml and edit the text you want to display in the toast notification. Reference that file using one of the script parameters. The following files should be present in the Script Directory when you create the package in MEMCM:- -** -Toast_Notify.ps1 + + +**Toast_Notify.ps1 BadgeImage.jpg HeroImage.jpg -CustomMessage.xml +CustomMessage.xml** + -** .PARAMETER XMLScriptDirSource Specify the name of the XML file to read. The XML file must exist in the same directory as Toast_Notify.ps1. If no parameter is passed, it is assumed the XML file is called CustomMessage.xml. From fbd203e20bd080fb6542eabb0ad09d226e345731 Mon Sep 17 00:00:00 2001 From: Ben Whitmore <44303264+byteben@users.noreply.github.com> Date: Wed, 22 Jul 2020 15:43:03 +0100 Subject: [PATCH 05/16] Update README.md --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 26b1b5d..d99990d 100644 --- a/README.md +++ b/README.md @@ -13,19 +13,19 @@ HeroImage.jpg CustomMessage.xml** -.PARAMETER XMLScriptDirSource +**.PARAMETER XMLScriptDirSource** Specify the name of the XML file to read. The XML file must exist in the same directory as Toast_Notify.ps1. If no parameter is passed, it is assumed the XML file is called CustomMessage.xml. -.PARAMETER XMLOtherSource +**.PARAMETER XMLOtherSource** Specify the location of the Custom XML file used for the Toast when it is not in the MEMCM package -.EXAMPLE +**.EXAMPLE** Toast_Notify.ps1 -XMLOtherSource "\\fileserverhome\xml\CustomMessage.xml" -.EXAMPLE +**.EXAMPLE** Toast_Notify.ps1 -XMLSciptDirSource "PhoneSystemProblems.xml" -.EXAMPLE +**.EXAMPLE** Toast_Notify.ps1 **Known Issues** From c8ec57078d10ab21f7f8c4a473e9b127f224e0c0 Mon Sep 17 00:00:00 2001 From: Ben Whitmore <44303264+byteben@users.noreply.github.com> Date: Wed, 22 Jul 2020 15:46:48 +0100 Subject: [PATCH 06/16] Update README.md --- README.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index d99990d..bd36ec1 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Toast -Toast_Notify.ps1 is a simple Toast Notification script designed to be deployed as a package from MEMCM +Toast_Notify.ps1 is a simple Toast Notification script designed to be deployed as a package from MEMCM Toast_Notify.ps1 will read an XML file on a file share so Toast Notifications can be changed "on the fly" without having to repackage. To create a custom XML, copy CustomMessage.xml and edit the text you want to display in the toast notification. Reference that file using one of the script parameters. @@ -30,3 +30,15 @@ Toast_Notify.ps1 **Known Issues** Currently, the images in the XML can only be read from the local files system. This is not an issue if we are deploying the package from MEMCM. Further development will see the ability to convert images to Base64 or host them on a web server + + +**Thanks for the help from** + + @guyrleech + @young_robbo + +**Community** + + Seriously check our Martin Bentsson's work on Toasts. It is very comprehensive. https://www.imab.dk/windows-10-toast-notification-script/ + I challenged myself to learn how Windows Toasts work so this was a labour of love for me. I have enjoyed the ride so far + From aa66e4eb99297ccd7d8422cdcebc858e98caa75a Mon Sep 17 00:00:00 2001 From: Ben Whitmore <44303264+byteben@users.noreply.github.com> Date: Wed, 22 Jul 2020 15:47:24 +0100 Subject: [PATCH 07/16] Update README.md --- README.md | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/README.md b/README.md index bd36ec1..935eea6 100644 --- a/README.md +++ b/README.md @@ -29,16 +29,13 @@ Toast_Notify.ps1 -XMLSciptDirSource "PhoneSystemProblems.xml" Toast_Notify.ps1 **Known Issues** -Currently, the images in the XML can only be read from the local files system. This is not an issue if we are deploying the package from MEMCM. Further development will see the ability to convert images to Base64 or host them on a web server - +Currently, the images in the XML can only be read from the local files system. This is not an issue if we are deploying the package from MEMCM. Further development will see the ability to convert images to Base64 or host them on a web server. **Thanks for the help from** - @guyrleech @young_robbo **Community** - Seriously check our Martin Bentsson's work on Toasts. It is very comprehensive. https://www.imab.dk/windows-10-toast-notification-script/ I challenged myself to learn how Windows Toasts work so this was a labour of love for me. I have enjoyed the ride so far From 20a9b8a058a067646c50f854d2bd344ceafcd67e Mon Sep 17 00:00:00 2001 From: Ben Whitmore <44303264+byteben@users.noreply.github.com> Date: Wed, 22 Jul 2020 15:47:55 +0100 Subject: [PATCH 08/16] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 935eea6..0012638 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Toast -Toast_Notify.ps1 is a simple Toast Notification script designed to be deployed as a package from MEMCM +Toast_Notify.ps1 is a simple Toast Notification script designed to be deployed as a package from MEMCM Toast_Notify.ps1 will read an XML file on a file share so Toast Notifications can be changed "on the fly" without having to repackage. To create a custom XML, copy CustomMessage.xml and edit the text you want to display in the toast notification. Reference that file using one of the script parameters. From ff014a92b0dc123714acc58bcfa5267487cd76a9 Mon Sep 17 00:00:00 2001 From: Ben Whitmore <44303264+byteben@users.noreply.github.com> Date: Wed, 22 Jul 2020 15:48:04 +0100 Subject: [PATCH 09/16] Update README.md --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 0012638..8c6816c 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,7 @@ # Toast -Toast_Notify.ps1 is a simple Toast Notification script designed to be deployed as a package from MEMCM +Toast_Notify.ps1 is a simple Toast Notification script designed to be deployed as a package from MEMCM + Toast_Notify.ps1 will read an XML file on a file share so Toast Notifications can be changed "on the fly" without having to repackage. To create a custom XML, copy CustomMessage.xml and edit the text you want to display in the toast notification. Reference that file using one of the script parameters. From 6273ef83eee736e6041f4abca799bc007bca4cf8 Mon Sep 17 00:00:00 2001 From: Ben Whitmore <44303264+byteben@users.noreply.github.com> Date: Wed, 22 Jul 2020 15:51:41 +0100 Subject: [PATCH 10/16] Update README.md --- README.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 8c6816c..e8f6c81 100644 --- a/README.md +++ b/README.md @@ -3,10 +3,13 @@ Toast_Notify.ps1 is a simple Toast Notification script designed to be deployed as a package from MEMCM Toast_Notify.ps1 will read an XML file on a file share so Toast Notifications can be changed "on the fly" without having to repackage. -To create a custom XML, copy CustomMessage.xml and edit the text you want to display in the toast notification. Reference that file using one of the script parameters. - -The following files should be present in the Script Directory when you create the package in MEMCM:- +To create a custom XML, copy CustomMessage.xml and edit the text you want to display in the toast notification. Reference that file using one of the script parameters. +**Points to Consider** + +I am using an existing app in Windows to call the Toasts. This script creates two buttons in the Toast, "Details" and "Dismiss". Cicking details is designed to take the user to an internal Service Desk announcement page. For that reason, **MSEdge** works really well because the Toast Action launches the browser in the foreground. Oh, you will need MSEdge installed on your client computers for this to work. + +The following files should be present in the Script Directory when you create the package in MEMCM:- **Toast_Notify.ps1 BadgeImage.jpg From 9bff7e8135cbb2c4250d93403d7b1facef0d35e2 Mon Sep 17 00:00:00 2001 From: Ben Whitmore <44303264+byteben@users.noreply.github.com> Date: Wed, 22 Jul 2020 15:57:06 +0100 Subject: [PATCH 11/16] Update README.md --- README.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index e8f6c81..2132f3a 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,7 @@ -# Toast - +# Toast + + https://byteben.com/bb/toast-example/ + Toast_Notify.ps1 is a simple Toast Notification script designed to be deployed as a package from MEMCM Toast_Notify.ps1 will read an XML file on a file share so Toast Notifications can be changed "on the fly" without having to repackage. From 359c7332bb14edaf722e772261a9d98f6b08e488 Mon Sep 17 00:00:00 2001 From: Ben Whitmore <44303264+byteben@users.noreply.github.com> Date: Wed, 22 Jul 2020 15:57:31 +0100 Subject: [PATCH 12/16] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 2132f3a..1331c81 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Toast - https://byteben.com/bb/toast-example/ + http://byteben.com/bb/wp-content/uploads/2020/07/Toast-Example.jpg Toast_Notify.ps1 is a simple Toast Notification script designed to be deployed as a package from MEMCM From 13f119ec2cd540f54896026ea7069da810e25945 Mon Sep 17 00:00:00 2001 From: Ben Whitmore <44303264+byteben@users.noreply.github.com> Date: Wed, 22 Jul 2020 15:58:06 +0100 Subject: [PATCH 13/16] Update README.md --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 1331c81..795eb0f 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,7 @@ # Toast - http://byteben.com/bb/wp-content/uploads/2020/07/Toast-Example.jpg + http://byteben.com/bb/wp-content/uploads/2020/07/Toast-Example.jpg + http://byteben.com/bb/wp-content/uploads/2020/07/Content-Example.jpg Toast_Notify.ps1 is a simple Toast Notification script designed to be deployed as a package from MEMCM From 47cbbde49f7e8ca2daaa5c3f2f90b4baec5e2cfa Mon Sep 17 00:00:00 2001 From: Ben Whitmore <44303264+byteben@users.noreply.github.com> Date: Wed, 22 Jul 2020 16:01:19 +0100 Subject: [PATCH 14/16] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 795eb0f..6d6e50f 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ http://byteben.com/bb/wp-content/uploads/2020/07/Toast-Example.jpg http://byteben.com/bb/wp-content/uploads/2020/07/Content-Example.jpg -Toast_Notify.ps1 is a simple Toast Notification script designed to be deployed as a package from MEMCM +Toast_Notify.ps1 is a simple Toast Notification script designed to be deployed as a package from MEMCM. The "Set and forget" mentality of packages works really well because we don't need to specify a detection method once the script has run. Toast_Notify.ps1 will read an XML file on a file share so Toast Notifications can be changed "on the fly" without having to repackage. To create a custom XML, copy CustomMessage.xml and edit the text you want to display in the toast notification. Reference that file using one of the script parameters. From efd1b0ac0e682848f1b3d6c29e6e62e3fcce926e Mon Sep 17 00:00:00 2001 From: Ben Whitmore <44303264+byteben@users.noreply.github.com> Date: Wed, 22 Jul 2020 16:21:56 +0100 Subject: [PATCH 15/16] Update README.md --- README.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/README.md b/README.md index 6d6e50f..abff930 100644 --- a/README.md +++ b/README.md @@ -8,8 +8,7 @@ Toast_Notify.ps1 is a simple Toast Notification script designed to be deployed a Toast_Notify.ps1 will read an XML file on a file share so Toast Notifications can be changed "on the fly" without having to repackage. To create a custom XML, copy CustomMessage.xml and edit the text you want to display in the toast notification. Reference that file using one of the script parameters. -**Points to Consider** - +**Points to Consider** I am using an existing app in Windows to call the Toasts. This script creates two buttons in the Toast, "Details" and "Dismiss". Cicking details is designed to take the user to an internal Service Desk announcement page. For that reason, **MSEdge** works really well because the Toast Action launches the browser in the foreground. Oh, you will need MSEdge installed on your client computers for this to work. The following files should be present in the Script Directory when you create the package in MEMCM:- From 211d29f020285865cdb83a0a68ba7d988a6f7330 Mon Sep 17 00:00:00 2001 From: Ben Whitmore <44303264+byteben@users.noreply.github.com> Date: Wed, 22 Jul 2020 16:38:01 +0100 Subject: [PATCH 16/16] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index abff930..c26f4fb 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ http://byteben.com/bb/wp-content/uploads/2020/07/Toast-Example.jpg http://byteben.com/bb/wp-content/uploads/2020/07/Content-Example.jpg -Toast_Notify.ps1 is a simple Toast Notification script designed to be deployed as a package from MEMCM. The "Set and forget" mentality of packages works really well because we don't need to specify a detection method once the script has run. +Toast_Notify.ps1 is a simple Toast Notification script designed to be deployed as a package from MEMCM. Toast_Notify.ps1 will read an XML file on a file share so Toast Notifications can be changed "on the fly" without having to repackage. To create a custom XML, copy CustomMessage.xml and edit the text you want to display in the toast notification. Reference that file using one of the script parameters.