Invoke-CMClientNotification

Sends a notification to client computers to trigger an immediate client action.

Syntax

Invoke-CMClientNotification
      [-Confirm]
      -Device <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      -NotificationType <ClientNotificationType>
      [-WhatIf]
      [<CommonParameters>]
Invoke-CMClientNotification [-Confirm] -DeviceCollection  [-DisableWildcardHandling]
 [-ForceWildcardHandling] -NotificationType  [-WhatIf] []
Invoke-CMClientNotification [-Confirm] -DeviceCollectionId  [-DisableWildcardHandling]
 [-ForceWildcardHandling] -NotificationType  [-WhatIf] []
Invoke-CMClientNotification [-Confirm] -DeviceCollectionName  [-DisableWildcardHandling]
 [-ForceWildcardHandling] -NotificationType  [-WhatIf] []
Invoke-CMClientNotification [-Confirm] -DeviceId  [-DisableWildcardHandling] [-ForceWildcardHandling]
 -NotificationType  [-WhatIf] []
Invoke-CMClientNotification [-Confirm] -DeviceName  [-DisableWildcardHandling] [-ForceWildcardHandling]
 -NotificationType  [-WhatIf] []

Description

The Invoke-CMClientNotification cmdlet sends a notification to client computers to trigger an immediate client action. You can specify one or more client computers, or send a notification to all the computers in a specified device collection.

Examples

Example 1: Send a notification to trigger an event

PS C:\>Invoke-CMClientNotification -DeviceName "Computer073" -NotificationType RequestMachinePolicyNow

This command sends a notification of the type RequestMachinePolicyNow to the device named Computer073.

Required Parameters

-Device

Specifies a CMDevice object. To obtain a CMDevice object, use the Get-CMDevice cmdlet.

Type:IResultObject
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-DeviceCollection

Specifies a CMDeviceCollection object. To obtain a CMDeviceCollection object, use the Get-CMDeviceCollection cmdlet.

Type:IResultObject
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-DeviceCollectionId

Specifies the ID of a device collection.

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeviceCollectionName

Specifies the name of a device collection.

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeviceId

Specifies the ID of a device.

Type:String
Aliases:ResourceID
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeviceName

Specifies a device name. You can specify a NetBIOS name or a fully qualified domain name (FQDN).

Type:String
Aliases:Name
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NotificationType

Specifies the type of notification to send. Valid values are: - RequestMachinePolicyNow. The client computer requests the latest machine policy from the management point. Machine policy includes configuration settings for a computer, or software updates that are deployed to a computer.

  • RequestUsersPolicyNow. The client computer requests the latest user policy from the management point. User policy includes applications or packages deployed for a user.
Type:ClientNotificationType
Parameter Sets:RequestMachinePolicyNow, RequestUsersPolicyNow
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

Indicates that wildcard handling is disabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

Indicates that wildcard handling is enabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False