Invoke-CMClientAction
SYNOPSIS
Odešle klientskému počítači oznámení, aby se spouštěl okamžitá akce klienta.
SYNTAX
SearchByValueMandatory (výchozí)
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
Rutina Invoke-CMClientAction odešle klientskému počítači oznámení, které aktivuje okamžitou akci klienta. Můžete zadat jeden nebo více klientských počítačů nebo odeslat oznámení všem počítačům v zadané kolekci zařízení.
Další informace o těchto akcích najdete v tématu Klientské oznámení.
Poznámka
Spusťte Správce konfigurace rutiny z Správce konfigurace lokality, například PS XYZ:\> . Další informace najdete v tématu Začínáme.
EXAMPLES
Příklad 1: Probuzení zařízení
Následující příklad odešle akci probuzení do zařízení v konkrétní kolekci:
Invoke-CMClientAction -DeviceName "SleepDevice01" -ActionType ClientNotificationWakeUpClientNow -ParentCollectionId $col.CollectionID
Příklad 2: Vyžádání zásad počítače ze zařízení
Tento příkaz odešle oznámení typu RequestMachinePolicyNow do zařízení s názvem Computer073 .
Invoke-CMClientAction -DeviceName "Computer073" -NotificationType RequestMachinePolicyNow
PARAMETERS
-ActionType
Zadejte klíčové slovo akce, které se má odeslat klientovi. Pokud chcete požádat o zásady počítače nebo uživatele, použijte parametr -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
Určete objekt kolekce, na který chcete cílit.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: DeviceCollection
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-CollectionId
Zadejte kolekci podle ID, na kterou chcete cílit.
Type: String
Parameter Sets: SearchByIdMandatory
Aliases: DeviceCollectionId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Zadejte kolekci podle názvu, na kterou chcete cílit.
Type: String
Parameter Sets: SearchByNameMandatory
Aliases: DeviceCollectionName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Device (Zařízení)
Určete objekt zařízení, na který chcete cílit.
Type: IResultObject
Parameter Sets: SearchByDeviceValueMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-DeviceId
Zadejte zařízení podle ID, na které se má cílit.
Type: String
Parameter Sets: SearchByDeviceIdMandatory
Aliases: ResourceId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeviceName
Zadejte zařízení podle názvu, na které chcete cílit.
Type: String
Parameter Sets: SearchByDeviceNameMandatory
Aliases: Name
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Tento parametr považuje zástupné znaky za hodnoty literálových znaků. Nemůžete ho kombinovat s forceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučuje se). Nemůžete ho kombinovat s příkazem DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NotificationType
Požádejte klienta o zásady počítače nebo uživatele. Pokud chcete aktivovat všechny ostatní akce, použijte parametr -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
Platí pro verzi 1906 a novější. Tento parametr použijte pro podporu probuzení počítače.
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
Platí pro verzi 1906 a novější. Tento parametr použijte pro podporu probuzení počítače.
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
Platí pro verzi 1906 a novější. Tento parametr použijte pro podporu probuzení počítače.
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
Zobrazuje, co by se stalo při spuštění rutiny. Nespouštěl rutinu .
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
System.Object
POZNÁMKY
Aliasy rutin: Invoke-CMClientNotification