Invoke-CMClientAction
SYNOPSIS
Wysyła powiadomienie do komputerów klienckich w celu wyzwolenia natychmiastowej akcji klienta.
SYNTAX
SearchByValueMandatory (ustawienie domyślne)
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
Polecenie cmdlet Invoke-CMClientAction wysyła powiadomienie do komputerów klienckich w celu wyzwolenia natychmiastowej akcji klienta. Można określić co najmniej jeden komputer kliencki lub wysłać powiadomienie do wszystkich komputerów w określonej kolekcji urządzeń.
Aby uzyskać więcej informacji na temat tych akcji, zobacz Powiadomienie klienta.
Uwaga
Uruchom Menedżer konfiguracji cmdlet z dysku Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.
EXAMPLES
Przykład 1: Wznawianie urządzenia
Poniższy przykład wysyła akcję wznawiania do urządzenia w określonej kolekcji:
Invoke-CMClientAction -DeviceName "SleepDevice01" -ActionType ClientNotificationWakeUpClientNow -ParentCollectionId $col.CollectionID
Przykład 2: żądanie zasad komputera z urządzenia
To polecenie wysyła powiadomienie typu do RequestMachinePolicyNow urządzenia o nazwie Computer073 .
Invoke-CMClientAction -DeviceName "Computer073" -NotificationType RequestMachinePolicyNow
PARAMETERS
-ActionType
Określ słowo kluczowe akcji do wysłania do klienta. Aby zażądać zasad komputera lub użytkownika, użyj parametru -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 (Kolekcja)
Określ obiekt kolekcji, który ma być obiektem docelowym.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: DeviceCollection
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-CollectionId
Określ kolekcję według identyfikatora docelowego.
Type: String
Parameter Sets: SearchByIdMandatory
Aliases: DeviceCollectionId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Określ kolekcję według nazwy obiektu docelowego.
Type: String
Parameter Sets: SearchByNameMandatory
Aliases: DeviceCollectionName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Urządzenia
Określ obiekt urządzenia, który ma być obiektem docelowym.
Type: IResultObject
Parameter Sets: SearchByDeviceValueMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-DeviceId
Określ urządzenie według identyfikatora docelowego.
Type: String
Parameter Sets: SearchByDeviceIdMandatory
Aliases: ResourceId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeviceName
Określ urządzenie według nazwy docelowego.
Type: String
Parameter Sets: SearchByDeviceNameMandatory
Aliases: Name
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Ten parametr traktuje symbole wieloznaczne jako wartości znaków literału. Nie można połączyć go z forceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NotificationType
Zażądaj zasad komputera lub użytkownika od klienta. Aby wyzwolić wszystkie inne akcje, użyj parametru -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
Dotyczy wersji 1906 i nowszych. Użyj tego parametru, aby obsługiwać wybudowanie maszyny.
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
Dotyczy wersji 1906 i nowszych. Użyj tego parametru, aby obsługiwać wybudowanie maszyny.
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
Dotyczy wersji 1906 i nowszych. Użyj tego parametru, aby obsługiwać wybudowanie maszyny.
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
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Typowe parametry
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
System.Object
UWAGI
Aliasy polecenia cmdlet: Invoke-CMClientNotification