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.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-DeviceCollection<IResultObject>
Specifies a CMDeviceCollection object. To obtain a CMDeviceCollection object, use the Get-CMDeviceCollection cmdlet.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-DeviceCollectionId<String>
Specifies the ID of a device collection.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-DeviceCollectionName<String>
Specifies the name of a device collection.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-DeviceId<String>
Specifies the ID of a device.
エイリアス |
ResourceID |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-DeviceName<String>
Specifies a device name. You can specify a NetBIOS name or a fully qualified domain name (FQDN).
エイリアス |
Name |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-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.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-Confirm
コマンドレットを実行する前に、ユーザーに確認を求めます。
必須? |
false |
位置は? |
named |
既定値 |
false |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-WhatIf
コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。
必須? |
false |
位置は? |
named |
既定値 |
false |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
<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