Condividi tramite

Invoke-CMClientAction

  • Riferimento
Modulo:
ConfigurationManager

Invia una notifica ai computer client per attivare un'azione client immediata.

Sintassi

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>]

Descrizione

Il cmdlet Invoke-CMClientAction invia una notifica ai computer client per attivare un'azione client immediata. È possibile specificare uno o più computer client o inviare una notifica a tutti i computer in una raccolta di dispositivi specificata.

Per altre informazioni su queste azioni, vedere Notifica client.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Riattivare un dispositivo

L'esempio seguente invia l'azione di riattivazione a un dispositivo in una raccolta specifica:

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

Esempio 2: Richiedere criteri computer da un dispositivo

Questo comando invia una notifica del tipo RequestMachinePolicyNow al dispositivo denominato Computer073.

Invoke-CMClientAction -DeviceName "Computer073" -NotificationType RequestMachinePolicyNow

Parametri

-ActionType

Specificare una parola chiave action da inviare al client. Per richiedere criteri utente o computer, usare il parametro -NotificationType .

Tipo:ClientActionType
Valori accettati: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
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Collection

Specificare un oggetto raccolta di destinazione.

Tipo:IResultObject
Alias:DeviceCollection
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-CollectionId

Specificare una raccolta in base all'ID di destinazione.

Tipo:String
Alias:DeviceCollectionId
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CollectionName

Specificare una raccolta in base al nome di destinazione.

Tipo:String
Alias:DeviceCollectionName
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Device

Specificare un oggetto dispositivo di destinazione.

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DeviceId

Specificare un dispositivo in base all'ID di destinazione.

Tipo:String
Alias:ResourceId
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeviceName

Specificare un dispositivo in base al nome di destinazione.

Tipo:String
Alias:Name
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NotificationType

Richiedere criteri utente o computer da un client. Per attivare tutte le altre azioni, usare il parametro -ActionType .

Tipo:ClientNotificationType
Valori accettati:RequestMachinePolicyNow, RequestUsersPolicyNow
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ParentCollection

Usare questo parametro per supportare l'attivazione di un computer.

Tipo:IResultObject
Alias:ParentDeviceCollection
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ParentCollectionId

Usare questo parametro per supportare l'attivazione di un computer.

Tipo:String
Alias:ParentDeviceCollectionId
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ParentCollectionName

Usare questo parametro per supportare l'attivazione di un computer.

Tipo:String
Alias:ParentDeviceCollectionName
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object

Note

Alias dei cmdlet: Invoke-CMClientNotification