Invoke-CMClientAction

  • リファレンス
モジュール:
ConfigurationManager

クライアント コンピューターに通知を送信して、即時のクライアント アクションをトリガーします。

構文

Invoke-CMClientAction
      [-ActionType <ClientActionType>]
      -Collection <IResultObject>
      [-NotificationType <ClientNotificationType>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-CMClientAction
      [-ActionType <ClientActionType>]
      -DeviceName <String>
      [-NotificationType <ClientNotificationType>]
      [-ParentCollection <IResultObject>]
      [-ParentCollectionId <String>]
      [-ParentCollectionName <String>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-CMClientAction
      [-ActionType <ClientActionType>]
      -DeviceId <String>
      [-NotificationType <ClientNotificationType>]
      [-ParentCollection <IResultObject>]
      [-ParentCollectionId <String>]
      [-ParentCollectionName <String>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-CMClientAction
      [-ActionType <ClientActionType>]
      -Device <IResultObject>
      [-NotificationType <ClientNotificationType>]
      [-ParentCollection <IResultObject>]
      [-ParentCollectionId <String>]
      [-ParentCollectionName <String>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-CMClientAction
      [-ActionType <ClientActionType>]
      -CollectionName <String>
      [-NotificationType <ClientNotificationType>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-CMClientAction
      [-ActionType <ClientActionType>]
      -CollectionId <String>
      [-NotificationType <ClientNotificationType>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Invoke-CMClientAction コマンドレットは、クライアント コンピューターに通知を送信して、即時のクライアント アクションをトリガーします。 1 つ以上のクライアント コンピューターを指定するか、指定したデバイス コレクション内のすべてのコンピューターに通知を送信できます。

これらのアクションの詳細については、「クライアント通知」 を参照してください。

注意

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。

例

例 1: デバイスをスリープ解除する

次の使用例は、特定のコレクション内のデバイスにウェイクアップ アクションを送信します。

Invoke-CMClientAction -DeviceName "SleepDevice01" -ActionType ClientNotificationWakeUpClientNow -ParentCollectionId $col.CollectionID

例 2: デバイスからコンピューター ポリシーを要求する

このコマンドは、型の通知をという RequestMachinePolicyNow 名前のデバイスに送信します Computer073 。

Invoke-CMClientAction -DeviceName "Computer073" -NotificationType RequestMachinePolicyNow

パラメーター

-ActionType

クライアントに送信するアクション キーワードを指定します。 コンピューターまたはユーザー ポリシーを要求するには 、-NotificationType パラメーターを使用 します。

Type:ClientActionType
Accepted values:None, EndpointProtectionFullScan, EndpointProtectionQuickScan, EndpointProtectionDownloadDefinition, EndpointProtectionEvaluateSoftwareUpdate, EndpointProtectionExcludeScanPaths, EndpointProtectionAllowThreat, EndpointProtectionRestoreQuarantinedItems, ClientNotificationRequestMachinePolicyNow, ClientNotificationRequestUsersPolicyNow, ClientNotificationRequestDDRNow, ClientNotificationRequestSWInvNow, ClientNotificationRequestHWInvNow, ClientNotificationAppDeplEvalNow, ClientNotificationSUMDeplEvalNow, ClientRequestSUPChangeNow, ClientRequestDHAChangeNow, ClientNotificationRebootMachine, DiagnosticsEnableVerboseLogging, DiagnosticsDisableVerboseLogging, DiagnosticsCollectFiles, EndpointProtectionRestoreWithDeps, ClientNotificationCheckComplianceNow, RequestScriptExecution, RequestCMPivotExecution, ClientNotificationWakeUpClientNow
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Collection

対象とするコレクション オブジェクトを指定します。

Type:IResultObject
Aliases:DeviceCollection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-CollectionId

対象となるコレクションを ID で指定します。

Type:String
Aliases:DeviceCollectionId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

対象となるコレクションを名前で指定します。

Type:String
Aliases:DeviceCollectionName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Device

ターゲットとするデバイス オブジェクトを指定します。

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-DeviceId

ターゲットとするデバイスを ID で指定します。

Type:String
Aliases:ResourceId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeviceName

ターゲットとするデバイスを名前で指定します。

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

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

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

-NotificationType

クライアントからコンピューターまたはユーザー ポリシーを要求します。 他のすべてのアクションをトリガーするには 、-ActionType パラメーターを使用 します。

Type:ClientNotificationType
Accepted values:RequestMachinePolicyNow, RequestUsersPolicyNow
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ParentCollection

コンピューターのスリープをサポートするには、このパラメーターを使用します。

Type:IResultObject
Aliases:ParentDeviceCollection
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ParentCollectionId

コンピューターのスリープをサポートするには、このパラメーターを使用します。

Type:String
Aliases:ParentDeviceCollectionId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ParentCollectionName

コンピューターのスリープをサポートするには、このパラメーターを使用します。

Type:String
Aliases:ParentDeviceCollectionName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

メモ

コマンドレットエイリアス: Invoke-CMClientNotification