Invoke-CMClientAction

Module:

ConfigurationManager

Envoie une notification aux ordinateurs clients pour déclencher une action immédiate du client.

Syntaxe

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

L’applet de commande Invoke-CMClientAction envoie une notification aux ordinateurs clients pour déclencher une action immédiate du client. Vous pouvez spécifier un ou plusieurs ordinateurs clients ou envoyer une notification à tous les ordinateurs d’un regroupement d’appareils spécifié.

Pour plus d’informations sur ces actions, consultez Notification du client.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Mettre en éveil un appareil

L’exemple suivant envoie l’action de mise en éveil à un appareil d’un regroupement spécifique :

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

Exemple 2 : Demander une stratégie d’ordinateur à partir d’un appareil

Cette commande envoie une notification du type RequestMachinePolicyNow à l’appareil nommé Computer073.

Invoke-CMClientAction -DeviceName "Computer073" -NotificationType RequestMachinePolicyNow

Paramètres

-ActionType

Spécifiez un mot clé d’action à envoyer au client. Pour demander une stratégie d’ordinateur ou d’utilisateur, utilisez le paramètre -NotificationType .

Type:	ClientActionType
Valeurs acceptées:	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
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Collection

Spécifiez un objet de collection à cibler.

Type:	IResultObject
Alias:	DeviceCollection
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-CollectionId

Spécifiez une collection par ID à cibler.

Type:	String
Alias:	DeviceCollectionId
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-CollectionName

Spécifiez une collection par son nom à cibler.

Type:	String
Alias:	DeviceCollectionName
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:	SwitchParameter
Alias:	cf
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Device

Spécifiez un objet d’appareil à cibler.

Type:	IResultObject
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-DeviceId

Spécifiez un appareil par ID à cibler.

Type:	String
Alias:	ResourceId
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DeviceName

Spécifiez un appareil par son nom à cibler.

Type:	String
Alias:	Name
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-NotificationType

Demander une stratégie d’ordinateur ou d’utilisateur à un client. Pour déclencher toutes les autres actions, utilisez le paramètre -ActionType .

Type:	ClientNotificationType
Valeurs acceptées:	RequestMachinePolicyNow, RequestUsersPolicyNow
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ParentCollection

Utilisez ce paramètre pour prendre en charge la veille d’une machine.

Type:	IResultObject
Alias:	ParentDeviceCollection
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ParentCollectionId

Utilisez ce paramètre pour prendre en charge la veille d’une machine.

Type:	String
Alias:	ParentDeviceCollectionId
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ParentCollectionName

Utilisez ce paramètre pour prendre en charge la veille d’une machine.

Type:	String
Alias:	ParentDeviceCollectionName
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. Il n’exécute pas l’applet de commande .

Type:	SwitchParameter
Alias:	wi
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object

Notes

Alias d’applet de commande : Invoke-CMClientNotification

Liens associés

• Get-CMDevice
• Get-CMDeviceCollection
• Notifications du client