Invoke-CMClientAction

將通知傳送至用戶端電腦,以觸發立即用戶端動作。

Syntax

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

CMClientAction Cmdlet 會傳送通知給用戶端電腦,以觸發立即用戶端動作。 您可以指定一或多部用戶端電腦,或將通知傳送至指定裝置集合中的所有電腦。

如需這些動作的相關資訊,請參閱 Client notification

注意

從 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 參數。

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

-CollectionId

依識別碼指定集合以進行目標。

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

執行 Cmdlet 之前提示您確認。

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

-DeviceId

依識別碼指定裝置以進行目標。

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

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

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

-裝置

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

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

-集合

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

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

輸入

ConfigurationManagement IResultObject

輸出

系統.物件

備註

Cmdlet 別名: 喚醒 CMClientNotification