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