Invoke-CMClientAction
SYNOPSIS
Skickar ett meddelande till klientdatorer för att utlösa en omedelbar klientåtgärd.
SYNTAX
SearchByValueMandatory (standard)
Invoke-CMClientAction [-ActionType <ClientActionType>] -Collection <IResultObject>
[-NotificationType <ClientNotificationType>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
[-Confirm] [<CommonParameters>]
SearchByDeviceNameMandatory
Invoke-CMClientAction [-ActionType <ClientActionType>] -DeviceName <String>
[-NotificationType <ClientNotificationType>] [-ParentCollection <IResultObject>]
[-ParentCollectionId <String>] [-ParentCollectionName <String>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByDeviceIdMandatory
Invoke-CMClientAction [-ActionType <ClientActionType>] -DeviceId <String>
[-NotificationType <ClientNotificationType>] [-ParentCollection <IResultObject>]
[-ParentCollectionId <String>] [-ParentCollectionName <String>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByDeviceValueMandatory
Invoke-CMClientAction [-ActionType <ClientActionType>] -Device <IResultObject>
[-NotificationType <ClientNotificationType>] [-ParentCollection <IResultObject>]
[-ParentCollectionId <String>] [-ParentCollectionName <String>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByNameMandatory
Invoke-CMClientAction [-ActionType <ClientActionType>] -CollectionName <String>
[-NotificationType <ClientNotificationType>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
[-Confirm] [<CommonParameters>]
SearchByIdMandatory
Invoke-CMClientAction [-ActionType <ClientActionType>] -CollectionId <String>
[-NotificationType <ClientNotificationType>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
[-Confirm] [<CommonParameters>]
DESCRIPTION
Cmdleten Invoke-CMClientAction skickar ett meddelande till klientdatorer för att utlösa en omedelbar klientåtgärd. Du kan ange en eller flera klientdatorer eller skicka ett meddelande till alla datorer i en angiven enhetssamling.
Mer information om de här åtgärderna finns i Klientmeddelande.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\>
. Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Väck en enhet
I följande exempel skickas aktiveringsåtgärden till en enhet i en specifik samling:
Invoke-CMClientAction -DeviceName "SleepDevice01" -ActionType ClientNotificationWakeUpClientNow -ParentCollectionId $col.CollectionID
Exempel 2: Begära datorprincip från en enhet
Det här kommandot skickar ett meddelande av typen RequestMachinePolicyNow
till enheten med namnet Computer073
.
Invoke-CMClientAction -DeviceName "Computer073" -NotificationType RequestMachinePolicyNow
PARAMETERS
-ActionType
Ange ett åtgärdsnyckelord som ska skickas till klienten. Om du vill begära dator- eller användarprincip använder du parametern -NotificationType.
Type: ClientActionType
Parameter Sets: (All)
Aliases:
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
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Samling
Ange ett samlingsobjekt som mål.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: DeviceCollection
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-CollectionId
Ange en samling efter ID som mål.
Type: String
Parameter Sets: SearchByIdMandatory
Aliases: DeviceCollectionId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Ange en samling efter namn på mål.
Type: String
Parameter Sets: SearchByNameMandatory
Aliases: DeviceCollectionName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Enhet
Ange ett enhetsobjekt som ska vara mål.
Type: IResultObject
Parameter Sets: SearchByDeviceValueMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-DeviceId
Ange en enhet efter ID som mål.
Type: String
Parameter Sets: SearchByDeviceIdMandatory
Aliases: ResourceId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeviceName
Ange en enhet efter namn som mål.
Type: String
Parameter Sets: SearchByDeviceNameMandatory
Aliases: Name
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NotificationType
Begär dator eller användarprincip från en klient. Om du vill utlösa alla andra åtgärder använder du parametern -ActionType.
Type: ClientNotificationType
Parameter Sets: (All)
Aliases:
Accepted values: RequestMachinePolicyNow, RequestUsersPolicyNow
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ParentCollection
Gäller för version 1906 och senare. Använd den här parametern som stöd för att skapa en dator.
Type: IResultObject
Parameter Sets: SearchByDeviceNameMandatory, SearchByDeviceIdMandatory, SearchByDeviceValueMandatory
Aliases: ParentDeviceCollection
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ParentCollectionId
Gäller för version 1906 och senare. Använd den här parametern som stöd för att skapa en dator.
Type: String
Parameter Sets: SearchByDeviceNameMandatory, SearchByDeviceIdMandatory, SearchByDeviceValueMandatory
Aliases: ParentDeviceCollectionId
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ParentCollectionName
Gäller för version 1906 och senare. Använd den här parametern som stöd för att skapa en dator.
Type: String
Parameter Sets: SearchByDeviceNameMandatory, SearchByDeviceIdMandatory, SearchByDeviceValueMandatory
Aliases: ParentDeviceCollectionName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Den kör inte cmdleten .
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
System.Object
ANTECKNINGAR
Cmdlet-alias: Invoke-CMClientNotification