Delen via


Invoke-CMClientAction

SYNOPSIS

Verzendt een melding naar clientcomputers om een onmiddellijke clientactie te activeren.

SYNTAX

SearchByValueMandatory (standaard)

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

De cmdlet Invoke-CMClientAction verzendt een melding naar clientcomputers om een onmiddellijke clientactie te activeren. U kunt een of meer clientcomputers opgeven of een melding verzenden naar alle computers in een opgegeven apparaatverzameling.

Zie Clientmelding voor meer informatie over deze acties.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: Een apparaat laten ontwaken

In het volgende voorbeeld wordt de wake-upactie naar een apparaat in een specifieke verzameling verzendt:

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

Voorbeeld 2: Machinebeleid aanvragen bij een apparaat

Met deze opdracht wordt een melding van het type RequestMachinePolicyNow naar het apparaat met de naam Computer073 verzendt.

Invoke-CMClientAction -DeviceName "Computer073" -NotificationType RequestMachinePolicyNow

PARAMETERS

-ActionType

Geef een trefwoord voor de actie op dat naar de client moet worden verzenden. Als u computer- of gebruikersbeleid wilt aanvragen, gebruikt u de parameter -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

-Collection

Geef een verzamelingsobject op dat moet worden gericht.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: DeviceCollection

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-CollectionId

Geef een verzameling op id op als doel.

Type: String
Parameter Sets: SearchByIdMandatory
Aliases: DeviceCollectionId

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

-CollectionName

Geef een verzameling op naam op als doel.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases: DeviceCollectionName

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-Apparaat

Geef een apparaatobject op dat moet worden gericht.

Type: IResultObject
Parameter Sets: SearchByDeviceValueMandatory
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-DeviceId

Geef een apparaat op id op dat moet worden gericht.

Type: String
Parameter Sets: SearchByDeviceIdMandatory
Aliases: ResourceId

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

-DeviceName

Geef een apparaat op naam op als doel.

Type: String
Parameter Sets: SearchByDeviceNameMandatory
Aliases: Name

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

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-NotificationType

Vraag computer- of gebruikersbeleid aan bij een client. Als u alle andere acties wilt activeren, gebruikt u de parameter -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

Is van toepassing op versie 1906 en hoger. Gebruik deze parameter om ondersteuning te bieden voor het maken van een machine.

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

Is van toepassing op versie 1906 en hoger. Gebruik deze parameter om ondersteuning te bieden voor het maken van een machine.

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

Is van toepassing op versie 1906 en hoger. Gebruik deze parameter om ondersteuning te bieden voor het maken van een machine.

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

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

OPMERKINGEN

Cmdlet-aliassen: Invoke-CMClientNotification

Get-CMDevice

Get-CMDeviceCollection

Clientmeldingen