Invoke-CMClientAction
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