Invoke-CMClientAction

Módulo:

ConfigurationManager

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

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

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 acerca de estas acciones, vea Notificación de cliente.

Nota

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

Ejemplos

Ejemplo 1: Activar un dispositivo

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

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

Ejemplo 2: Solicitar la 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

- Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

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

-ActionType

Especifique una palabra clave de acción que se enviará al cliente. Para solicitar la directiva de usuario o máquina, use el parámetro -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

-Collection

Especifique un objeto de colección al destino.

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

-CollectionId

Especifique una colección por identificador de destino.

Type:	String
Aliases:	DeviceCollectionId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionName

Especifique una colección por su nombre al destino.

Type:	String
Aliases:	DeviceCollectionName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Device

Especifique un objeto de dispositivo al que dirigirse.

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

-DeviceId

Especifica un dispositivo por identificador de destino.

Type:	String
Aliases:	ResourceId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeviceName

Especifica un dispositivo por nombre para el destino.

Type:	String
Aliases:	Name
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-NotificationType

Solicitar una directiva de usuario o equipo desde un cliente. Para desencadenar todas las demás acciones, use el parámetro -ActionType.

Type:	ClientNotificationType
Accepted values:	RequestMachinePolicyNow, RequestUsersPolicyNow
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ParentCollection

Use este parámetro para admitir la vigilia de una máquina.

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

-ParentCollectionId

Use este parámetro para admitir la vigilia de una máquina.

Type:	String
Aliases:	ParentDeviceCollectionId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ParentCollectionName

Use este parámetro para admitir la vigilia de una máquina.

Type:	String
Aliases:	ParentDeviceCollectionName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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