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