Invoke-CMClientAction

  • Artigo

SYNOPSIS

Envia uma notificação aos computadores clientes para desencadear uma ação imediata do cliente.

SYNTAX

SearchByValueMandatory (Padrão)

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

PesquisaByNameMandatory

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

O Cmdlet Invoke-CMClientAction envia uma notificação aos computadores clientes para desencadear uma ação imediata do cliente. Pode especificar um ou mais computadores clientes ou enviar uma notificação a todos os computadores numa recolha de dispositivos especificada.

Para obter mais informações sobre estas ações, consulte a notificação do Cliente.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

Exemplo 1: Acorde um dispositivo

O exemplo a seguir envia a ação de despertar para um dispositivo numa coleção específica:

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

Exemplo 2: Solicitar a política da máquina a partir de um dispositivo

Este comando envia uma notificação do tipo RequestMachinePolicyNow para o dispositivo denominado Computer073 .

Invoke-CMClientAction -DeviceName "Computer073" -NotificationType RequestMachinePolicyNow

PARAMETERS

-ActionType

Especifique uma palavra-chave de ação para enviar ao cliente. Para solicitar a política da máquina ou do utilizador, utilize o parâmetro -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

-Coleção

Especifique um objeto de recolha para o alvo.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: DeviceCollection

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

-CollectionId

Especifique uma coleção por ID para o alvo.

Type: String
Parameter Sets: SearchByIdMandatory
Aliases: DeviceCollectionId

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

-Nome de coleção

Especifique uma coleção pelo nome para o alvo.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases: DeviceCollectionName

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

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

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

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

-Dispositivo

Especifique um objeto do dispositivo para o alvo.

Type: IResultObject
Parameter Sets: SearchByDeviceValueMandatory
Aliases:

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

-DeviceId

Especifique um dispositivo por ID para o alvo.

Type: String
Parameter Sets: SearchByDeviceIdMandatory
Aliases: ResourceId

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

-Nome do dispositivo

Especifique um dispositivo por nome para o alvo.

Type: String
Parameter Sets: SearchByDeviceNameMandatory
Aliases: Name

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

-DisableWildcardHandling

Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-NotificaçãoType

Solicite a máquina ou a política do utilizador a um cliente. Para desencadear todas as outras ações, utilize o parâmetro -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

Aplica-se à versão 1906 e mais tarde. Utilize este parâmetro para apoiar o despertar de uma máquina.

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

Aplica-se à versão 1906 e mais tarde. Utilize este parâmetro para apoiar o despertar de uma máquina.

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

Aplica-se à versão 1906 e mais tarde. Utilize este parâmetro para apoiar o despertar de uma máquina.

Type: String
Parameter Sets: SearchByDeviceNameMandatory, SearchByDeviceIdMandatory, SearchByDeviceValueMandatory
Aliases: ParentDeviceCollectionName

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

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. Não funciona o cmdlet.

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

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

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

Sistema.Objeto

NOTAS

Pseudónimos do Cmdlet: Invocar-CMClientNotification

Get-CMDevice

Get-CMDeviceCollection

Notificações de clientes