Une communication efficace avec les utilisateurs finaux est la cl\u00e9 de vopute des op\u00e9rations informatiques, en particulier pour les fournisseurs de services g\u00e9r\u00e9s (MSP)<\/a> et les professionnels de l’informatique qui g\u00e8rent des environnements \u00e0 grande \u00e9chelle. S’assurer que les messages critiques sont vus rapidement peut faire la diff\u00e9rence entre une r\u00e9solution sans faille et des op\u00e9rations perturb\u00e9es. Ce script PowerShell<\/a> offre un moyen efficace d’envoyer des notifications toast importantes directement \u00e0 l’utilisateur connect\u00e9 sur un syst\u00e8me Windows.<\/p>\n Les notifications toast sont devenues un \u00e9l\u00e9ment essentiel des flux de travail informatiques modernes, car elles constituent un moyen non intrusif mais imm\u00e9diat de communiquer des informations. Qu’il s’agisse d’alerter les utilisateurs sur une mise \u00e0 jour critique, un changement de politique de s\u00e9curit\u00e9 ou une fen\u00eatre de maintenance imminente, ces notifications assurent la visibilit\u00e9 sans interrompre le flux de travail. Les approches traditionnelles font souvent appel \u00e0 des e-mails en masse ou \u00e0 des fen\u00eatres contextuelles, qui sont soit trop d\u00e9rangeants, soit faciles \u00e0 ignorer. Ce script r\u00e9pond \u00e0 ces limitations en tirant parti du syst\u00e8me de notification natif de Windows pour envoyer des messages cibl\u00e9s et personnalisables.<\/p>\n <\/p>\n\nContexte<\/h2>\n
Le script\u00a0:<\/h2>\n
#Requires -Version 5.1\r\n\r\n<#\r\n.SYNOPSIS\r\n Sends an important toast notification to the currently signed in user. Please run as the Current Logged-on User.\r\n.DESCRIPTION\r\n Sends an important toast notification to the currently signed in user. Please run as 'Current Logged on User'.\r\n You can also specify the \"ApplicationId\" to any string.\r\n The default ApplicationId is your company name found in the NINJA_COMPANY_NAME environment variable, but will fallback to \"NinjaOne RMM\" if it happens to not be set.\r\n\r\n By using this script, you indicate your acceptance of the following legal terms as well as our Terms of Use at https:\/\/www.ninjaone.com\/terms-of-use.\r\n Ownership Rights: NinjaOne owns and will continue to own all right, title, and interest in and to the script (including the copyright). NinjaOne is giving you a limited license to use the script in accordance with these legal terms. \r\n Use Limitation: You may only use the script for your legitimate personal or internal business purposes, and you may not share the script with another party. \r\n Republication Prohibition: Under no circumstances are you permitted to re-publish the script in any script library or website belonging to or under the control of any other software provider. \r\n Warranty Disclaimer: The script is provided \u201cas is\u201d and \u201cas available\u201d, without warranty of any kind. NinjaOne makes no promise or guarantee that the script will be free from defects or that it will meet your specific needs or expectations. \r\n Assumption of Risk: Your use of the script is at your own risk. You acknowledge that there are certain inherent risks in using the script, and you understand and assume each of those risks. \r\n Waiver and Release: You will not hold NinjaOne responsible for any adverse or unintended consequences resulting from your use of the script, and you waive any legal or equitable rights or remedies you may have against NinjaOne relating to your use of the script. \r\n EULA: If you are a NinjaOne customer, your use of the script is subject to the End User License Agreement applicable to you (EULA).\r\n\r\n.EXAMPLE\r\n -Title \"My Title Here\" -Message \"My Message Here\"\r\n Sends the title \"My Title Here\" and message \"My Message Here\" as a Toast message\/notification to the currently signed in user.\r\n.EXAMPLE\r\n -Title \"My Title Here\" -Message \"My Message Here\" -ApplicationId \"MyCompany\"\r\n Sends the title \"My Title Here\" and message \"My Message Here\" as a Toast message\/notification to the currently signed in user.\r\n ApplicationId: Creates a registry entry for your toasts called \"MyCompany\".\r\n.OUTPUTS\r\n None\r\n.NOTES\r\n If you want to change the defaults then with in the param block.\r\n If you want to customize the application name to show your company name,\r\n then look for $ApplicationId and change the content between the double quotes.\r\n\r\n Minimum OS Architecture Supported: Windows 10 (IoT editions are not supported due to lack of shell)\r\n Release Notes: Initial Release\r\n#>\r\n\r\n[CmdletBinding()]\r\nparam\r\n(\r\n [string]$Title,\r\n [string]$Message,\r\n [string]$ApplicationId\r\n)\r\n\r\nbegin {\r\n # Set the default ApplicationId if it's not provided. Use the Company Name if available, otherwise use the default.\r\n $ApplicationId = if ($env:NINJA_COMPANY_NAME) { $env:NINJA_COMPANY_NAME } else { \"NinjaOne RMM\" }\r\n\r\n Write-Host \"[Info] Using ApplicationId: $($ApplicationId -replace '\\s+','.')\"\r\n\r\n if ($env:title -and $env:title -notlike \"null\") { $Title = $env:title }\r\n if ($env:message -and $env:message -notlike \"null\") { $Message = $env:message }\r\n if ($env:applicationId -and $env:applicationId -notlike \"null\") { $ApplicationId = $env:applicationId }\r\n\r\n if ([String]::IsNullOrWhiteSpace($Title)) {\r\n Write-Host \"[Error] A Title is required.\"\r\n exit 1\r\n }\r\n if ([String]::IsNullOrWhiteSpace($Message)) {\r\n Write-Host \"[Error] A Message is required.\"\r\n exit 1\r\n }\r\n\r\n if ($Title.Length -gt 42) {\r\n Write-Host \"[Warn] The Title is longer than 42 characters. The title will be truncated by the Windows API to 42 characters.\"\r\n }\r\n if ($Message.Length -gt 254) {\r\n Write-Host \"[Warn] The Message is longer than 254 characters. The message might get truncated by the Windows API.\"\r\n }\r\n\r\n function Test-IsSystem {\r\n $id = [System.Security.Principal.WindowsIdentity]::GetCurrent()\r\n return $id.Name -like \"NT AUTHORITY*\" -or $id.IsSystem\r\n }\r\n\r\n if (Test-IsSystem) {\r\n Write-Host \"[Error] Please run this script as 'Current Logged on User'.\"\r\n Exit 1\r\n }\r\n\r\n function Set-RegKey {\r\n param (\r\n $Path,\r\n $Name,\r\n $Value,\r\n [ValidateSet(\"DWord\", \"QWord\", \"String\", \"ExpandedString\", \"Binary\", \"MultiString\", \"Unknown\")]\r\n $PropertyType = \"DWord\"\r\n )\r\n if (-not $(Test-Path -Path $Path)) {\r\n # Check if path does not exist and create the path\r\n New-Item -Path $Path -Force | Out-Null\r\n }\r\n if ((Get-ItemProperty -Path $Path -Name $Name -ErrorAction Ignore)) {\r\n # Update property and print out what it was changed from and changed to\r\n $CurrentValue = (Get-ItemProperty -Path $Path -Name $Name -ErrorAction Ignore).$Name\r\n try {\r\n Set-ItemProperty -Path $Path -Name $Name -Value $Value -Force -Confirm:$false -ErrorAction Stop | Out-Null\r\n }\r\n catch {\r\n Write-Host \"[Error] Unable to Set registry key for $Name please see below error!\"\r\n Write-Host \"$($_.Exception.Message)\"\r\n exit 1\r\n }\r\n Write-Host \"[Info] $Path\\$Name changed from:\"\r\n Write-Host \" $CurrentValue to:\"\r\n Write-Host \" $($(Get-ItemProperty -Path $Path -Name $Name -ErrorAction Ignore).$Name)\"\r\n }\r\n else {\r\n # Create property with value\r\n try {\r\n New-ItemProperty -Path $Path -Name $Name -Value $Value -PropertyType $PropertyType -Force -Confirm:$false -ErrorAction Stop | Out-Null\r\n }\r\n catch {\r\n Write-Host \"[Error] Unable to Set registry key for $Name please see below error!\"\r\n Write-Host \"$($_.Exception.Message)\"\r\n exit 1\r\n }\r\n Write-Host \"[Info] Set $Path\\$Name to:\"\r\n Write-Host \" $($(Get-ItemProperty -Path $Path -Name $Name -ErrorAction Ignore).$Name)\"\r\n }\r\n }\r\n\r\n function Show-Notification {\r\n [CmdletBinding()]\r\n Param (\r\n [string]\r\n $ApplicationId,\r\n [string]\r\n $ToastTitle,\r\n [string]\r\n [Parameter(ValueFromPipeline)]\r\n $ToastText\r\n )\r\n\r\n # Import all the needed libraries\r\n [Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] > $null\r\n [Windows.UI.Notifications.ToastNotification, Windows.UI.Notifications, ContentType = WindowsRuntime] > $null\r\n [Windows.System.User, Windows.System, ContentType = WindowsRuntime] > $null\r\n [Windows.System.UserType, Windows.System, ContentType = WindowsRuntime] > $null\r\n [Windows.System.UserAuthenticationStatus, Windows.System, ContentType = WindowsRuntime] > $null\r\n [Windows.Storage.ApplicationData, Windows.Storage, ContentType = WindowsRuntime] > $null\r\n\r\n # Make sure that we can use the toast manager, also checks if the service is running and responding\r\n try {\r\n $ToastNotifier = [Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier(\"$ApplicationId\")\r\n }\r\n catch {\r\n Write-Host \"$($_.Exception.Message)\"\r\n Write-Host \"[Error] Failed to create notification.\"\r\n }\r\n\r\n # Create a new toast notification\r\n $RawXml = [xml] @\"\r\n<toast scenario='urgent'>\r\n <visual>\r\n <binding template='ToastGeneric'>\r\n <text hint-maxLines='1'>$ToastTitle<\/text>\r\n <text>$ToastText<\/text>\r\n <\/binding>\r\n <\/visual>\r\n<\/toast>\r\n\"@\r\n\r\n # Serialized Xml for later consumption\r\n $SerializedXml = New-Object Windows.Data.Xml.Dom.XmlDocument\r\n $SerializedXml.LoadXml($RawXml.OuterXml)\r\n\r\n # Setup how are toast will act, such as expiration time\r\n $Toast = $null\r\n $Toast = [Windows.UI.Notifications.ToastNotification]::new($SerializedXml)\r\n $Toast.Tag = \"PowerShell\"\r\n $Toast.Group = \"PowerShell\"\r\n $Toast.ExpirationTime = [DateTimeOffset]::Now.AddMinutes(1)\r\n\r\n # Show our message to the user\r\n $ToastNotifier.Show($Toast)\r\n }\r\n}\r\nprocess {\r\n # Create an object to store the ApplicationId and DisplayName\r\n $Application = [PSCustomObject]@{\r\n DisplayName = $ApplicationId\r\n # Replace any spaces with a period in the ApplicationId\r\n AppId = $($ApplicationId -replace '\\s+', '.')\r\n }\r\n Write-Host \"Display Name: $($Application.DisplayName)\"\r\n Write-Host \"Application ID: $($Application.AppId)\"\r\n\r\n Set-RegKey -Path \"HKCU:\\SOFTWARE\\Classes\\AppUserModelId\\$($Application.AppId)\" -Name \"DisplayName\" -Value $Application.DisplayName -PropertyType String\r\n Set-RegKey -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Notifications\\Settings\\$($Application.AppId)\" -Name \"AllowUrgentNotifications\" -Value 1 -PropertyType DWord\r\n\r\n try {\r\n Write-Host \"[Info] Attempting to send message to user...\"\r\n $NotificationParams = @{\r\n ToastTitle = $Title\r\n ToastText = $Message\r\n ApplicationId = $Application.AppId\r\n }\r\n Show-Notification @NotificationParams -ErrorAction Stop\r\n Write-Host \"[Info] Message sent to user.\"\r\n }\r\n catch {\r\n Write-Host \"[Error] Failed to send message to user.\"\r\n Write-Host \"$($_.Exception.Message)\"\r\n exit 1\r\n }\r\n exit 0\r\n}\r\nend {\r\n \r\n \r\n \r\n}<\/pre>\n