Invoke-CMClientAction

Módulo:

ConfigurationManager

Envía una notificación a los equipos cliente para desencadenar una acción de cliente inmediata.

Sintaxis

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

El cmdlet Invoke-CMClientAction envía una notificación a los equipos cliente para desencadenar una acción de cliente inmediata. Puede especificar uno o varios equipos cliente o enviar una notificación a todos los equipos de una colección de dispositivos especificada.

Para obtener más información sobre estas acciones, consulte Notificación de cliente.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Reactivación de un dispositivo

En el ejemplo siguiente se envía la acción de reactivación a un dispositivo de una colección específica:

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

Ejemplo 2: Solicitud de directiva de máquina desde un dispositivo

Este comando envía una notificación del tipo RequestMachinePolicyNow al dispositivo denominado Computer073.

Invoke-CMClientAction -DeviceName "Computer073" -NotificationType RequestMachinePolicyNow

Parámetros

-ActionType

Especifique una palabra clave action para enviar al cliente. Para solicitar la máquina o la directiva de usuario, use el parámetro -NotificationType .

Tipo:	ClientActionType
Valores aceptados:	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
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Collection

Especifique un objeto de colección de destino.

Tipo:	IResultObject
Alias:	DeviceCollection
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-CollectionId

Especifique una colección por identificador para el destino.

Tipo:	String
Alias:	DeviceCollectionId
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CollectionName

Especifique una colección por nombre para el destino.

Tipo:	String
Alias:	DeviceCollectionName
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Device

Especifique un objeto de dispositivo de destino.

Tipo:	IResultObject
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-DeviceId

Especifique un dispositivo por identificador para el destino.

Tipo:	String
Alias:	ResourceId
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DeviceName

Especifique un dispositivo por nombre para el destino.

Tipo:	String
Alias:	Name
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-NotificationType

Solicitar directiva de usuario o máquina a un cliente. Para desencadenar todas las demás acciones, use el parámetro -ActionType .

Tipo:	ClientNotificationType
Valores aceptados:	RequestMachinePolicyNow, RequestUsersPolicyNow
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ParentCollection

Use este parámetro para admitir la reactivación de una máquina.

Tipo:	IResultObject
Alias:	ParentDeviceCollection
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ParentCollectionId

Use este parámetro para admitir la reactivación de una máquina.

Tipo:	String
Alias:	ParentDeviceCollectionId
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ParentCollectionName

Use este parámetro para admitir la reactivación de una máquina.

Tipo:	String
Alias:	ParentDeviceCollectionName
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. No ejecuta el cmdlet .

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object

Notas

Alias de cmdlet: Invoke-CMClientNotification

Vínculos relacionados

• Get-CMDevice
• Get-CMDeviceCollection
• Notificaciones de cliente