Invoke-CMClientNotification

Invoke-CMClientNotification

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

構文

Parameter Set: SearchByDeviceIdMandatory
Invoke-CMClientNotification -DeviceId <String> [-NotificationType <ClientNotificationType> {RequestMachinePolicyNow | RequestUsersPolicyNow} ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByDeviceNameMandatory
Invoke-CMClientNotification -DeviceName <String> [-NotificationType <ClientNotificationType> {RequestMachinePolicyNow | RequestUsersPolicyNow} ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByDeviceValueMandatory
Invoke-CMClientNotification -Device <IResultObject> [-NotificationType <ClientNotificationType> {RequestMachinePolicyNow | RequestUsersPolicyNow} ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByIdMandatory
Invoke-CMClientNotification -DeviceCollectionId <String> [-NotificationType <ClientNotificationType> {RequestMachinePolicyNow | RequestUsersPolicyNow} ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByNameMandatory
Invoke-CMClientNotification -DeviceCollectionName <String> [-NotificationType <ClientNotificationType> {RequestMachinePolicyNow | RequestUsersPolicyNow} ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByValueMandatory
Invoke-CMClientNotification -DeviceCollection <IResultObject> [-NotificationType <ClientNotificationType> {RequestMachinePolicyNow | RequestUsersPolicyNow} ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

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.

パラメーター

-Device<IResultObject>

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

-DeviceCollection<IResultObject>

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

-DeviceCollectionId<String>

Specifies the ID of a device collection.

-DeviceCollectionName<String>

Specifies the name of a device collection.

-DeviceId<String>

Specifies the ID of a device.

-DeviceName<String>

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

-NotificationType<ClientNotificationType>

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.

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

例

Example: Send a notification to trigger an event

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

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

関連トピック

Get-CMDevice

Get-CMDeviceCollection