Invoke-CMClientAction
Sendet eine Benachrichtigung an Clientcomputer, um eine sofortige Clientaktion auszulösen.
Syntax
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>]
Beschreibung
Das Cmdlet "Invoke-CMClientAction" sendet eine Benachrichtigung an Clientcomputer, um eine sofortige Clientaktion auszulösen. Sie können einen oder mehrere Clientcomputer angeben oder eine Benachrichtigung an alle Computer in einer angegebenen Gerätesammlung senden.
Weitere Informationen zu diesen Aktionen finden Sie unter Clientbenachrichtigung.
Hinweis
Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\>
aus. Weitere Informationen finden Sie unter "Erste Schritte".
Beispiele
Beispiel 1: Aufwachen eines Geräts
Im folgenden Beispiel wird die Reaktivierungsaktion an ein Gerät in einer bestimmten Auflistung gesendet:
Invoke-CMClientAction -DeviceName "SleepDevice01" -ActionType ClientNotificationWakeUpClientNow -ParentCollectionId $col.CollectionID
Beispiel 2: Anfordern einer Computerrichtlinie von einem Gerät
Dieser Befehl sendet eine Benachrichtigung des Typs RequestMachinePolicyNow
an das Gerät mit dem Namen Computer073
.
Invoke-CMClientAction -DeviceName "Computer073" -NotificationType RequestMachinePolicyNow
Parameter
-ActionType
Geben Sie ein Aktionsstichwort an, das an den Client gesendet werden soll. Verwenden Sie zum Anfordern einer Computer- oder Benutzerrichtlinie den Parameter "-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
Geben Sie ein Auflistungsobjekt an, das als Ziel verwendet werden soll.
Type: | IResultObject |
Aliases: | DeviceCollection |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CollectionId
Geben Sie eine Auflistung nach ID an, die als Ziel festgelegt werden soll.
Type: | String |
Aliases: | DeviceCollectionId |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Geben Sie eine Auflistung anhand des Zielnamens an.
Type: | String |
Aliases: | DeviceCollectionName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Device
Geben Sie ein Geräteobjekt an, das als Ziel verwendet werden soll.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DeviceId
Geben Sie ein Gerät nach ID an, das als Ziel festgelegt werden soll.
Type: | String |
Aliases: | ResourceId |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeviceName
Geben Sie ein Gerät anhand des Zielnamens an.
Type: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NotificationType
Fordern Sie computer- oder benutzerrichtlinien von einem Client an. Verwenden Sie den Parameter "-ActionType", um alle anderen Aktionen auszulösen.
Type: | ClientNotificationType |
Accepted values: | RequestMachinePolicyNow, RequestUsersPolicyNow |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ParentCollection
Verwenden Sie diesen Parameter, um das Aufwachen eines Computers zu unterstützen.
Type: | IResultObject |
Aliases: | ParentDeviceCollection |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ParentCollectionId
Verwenden Sie diesen Parameter, um das Aufwachen eines Computers zu unterstützen.
Type: | String |
Aliases: | ParentDeviceCollectionId |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ParentCollectionName
Verwenden Sie diesen Parameter, um das Aufwachen eines Computers zu unterstützen.
Type: | String |
Aliases: | ParentDeviceCollectionName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
System.Object
Hinweise
Cmdlet-Aliase: Invoke-CMClientNotification