共用方式為

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>]

Description

Invoke-CMClientAction Cmdlet 會將通知傳送至用戶端計算機，以觸發立即的客戶端動作。 您可以指定一或多部用戶端計算機，或將通知傳送至指定裝置集合中的所有計算機。

如需這些動作的詳細資訊，請參閱 用戶端通知。

注意事項

從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。

範例

範例 1：喚醒裝置

下列範例會將喚醒動作傳送至特定集合中的裝置：

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

範例 2：從裝置要求機器原則

此命令會將類型的 RequestMachinePolicyNow 通知傳送至名為的 Computer073裝置。

Invoke-CMClientAction -DeviceName "Computer073" -NotificationType RequestMachinePolicyNow

參數

-ActionType

指定要傳送至客戶端的動作關鍵字。 若要要求機器或用戶原則，請使用 -NotificationType 參數。

類型:ClientActionType
接受的值: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
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Collection

指定要設為目標的集合物件。

類型:IResultObject
別名:DeviceCollection
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-CollectionId

依標識元指定要設為目標的集合。

類型:String
別名:DeviceCollectionId
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-CollectionName

依名稱指定要設為目標的集合。

類型:String
別名:DeviceCollectionName
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Confirm

執行 Cmdlet 之前提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Device

指定要設為目標的裝置物件。

類型:IResultObject
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-DeviceId

依標識元指定要設為目標的裝置。

類型:String
別名:ResourceId
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-DeviceName

依名稱指定要設為目標的裝置。

類型:String
別名:Name
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-DisableWildcardHandling

此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ForceWildcardHandling

此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-NotificationType

向用戶端要求機器或用戶原則。 若要觸發所有其他動作，請使用 -ActionType 參數。

類型:ClientNotificationType
接受的值:RequestMachinePolicyNow, RequestUsersPolicyNow
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ParentCollection

使用此參數來支持喚醒機器。

類型:IResultObject
別名:ParentDeviceCollection
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ParentCollectionId

使用此參數來支持喚醒機器。

類型:String
別名:ParentDeviceCollectionId
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ParentCollectionName

使用此參數來支持喚醒機器。

類型:String
別名:ParentDeviceCollectionName
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 它不會執行 Cmdlet。

類型:SwitchParameter
別名:wi
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

System.Object

備註

Cmdlet 別名： Invoke-CMClientNotification