Invoke-CMClientAction

Модуль:

ConfigurationManager

Отправляет уведомление на клиентские компьютеры, чтобы вызвать немедленное действие клиента.

Синтаксис

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

Описание

Комлет Invoke-CMClientAction отправляет уведомление на клиентские компьютеры, чтобы вызвать немедленное действие клиента. Вы можете указать один или несколько клиентских компьютеров или отправить уведомление на все компьютеры в указанной коллекции устройств.

Дополнительные сведения об этих действиях см. в уведомлении клиента.

Примечание

Запустите команды диспетчера конфигурации из диска веб-сайта Configuration Manager, например PS XYZ:\> . Дополнительные сведения см. в дополнительных сведениях о том, как начать работу.

Примеры

Пример 1. Разбудить устройство

В следующем примере действие пробуждения отправляется на устройство в определенной коллекции:

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

Пример 2. Политика запроса компьютера с устройства

Эта команда отправляет уведомление о типе RequestMachinePolicyNow устройству с именем Computer073 .

Invoke-CMClientAction -DeviceName "Computer073" -NotificationType RequestMachinePolicyNow

Параметры

-ActionType

Укажите ключевое слово действия для отправки клиенту. Чтобы запросить машину или политику пользователя, используйте параметр -NotificationType.

Type:	ClientActionType
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
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Collection

Укажите целевой объект коллекции.

Type:	IResultObject
Aliases:	DeviceCollection
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-CollectionId

Укажите коллекцию по ID для целевой цели.

Type:	String
Aliases:	DeviceCollectionId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionName

Укажите коллекцию по имени для целевой цели.

Type:	String
Aliases:	DeviceCollectionName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Перед запуском командлет запросит подтверждение.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Device

Укажите объект устройства для целевого объекта.

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

-DeviceId

Укажите устройство по ID для целевой цели.

Type:	String
Aliases:	ResourceId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeviceName

Укажите целевое устройство по имени.

Type:	String
Aliases:	Name
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

Этот параметр рассматривает символы под диктовки как буквальные значения символов. Вы не можете объединить его с ForceWildcardHandling.

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

-ForceWildcardHandling

Этот параметр обрабатывает символы под диктовки и может привести к неожиданному поведению (не рекомендуется). Вы не можете объединить его с DisableWildcardHandling.

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

-NotificationType

Запрос машины или политики пользователя от клиента. Чтобы вызвать все другие действия, используйте параметр -ActionType.

Type:	ClientNotificationType
Accepted values:	RequestMachinePolicyNow, RequestUsersPolicyNow
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ParentCollection

Используйте этот параметр для поддержки пробуждения компьютера.

Type:	IResultObject
Aliases:	ParentDeviceCollection
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ParentCollectionId

Используйте этот параметр для поддержки пробуждения компьютера.

Type:	String
Aliases:	ParentDeviceCollectionId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ParentCollectionName

Используйте этот параметр для поддержки пробуждения компьютера.

Type:	String
Aliases:	ParentDeviceCollectionName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Он не запускает этот кодлет.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Выходные данные

System.Object

Примечания

Псевдонимы cmdlet: Invoke-CMClientNotification

Связанные ссылки

• Get-CMDevice
• Get-CMDeviceCollection
• Клиентские уведомления