Invoke-CMClientAction

Modul:

ConfigurationManager

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

Ähnliche Themen

• Get-CMDevice
• Get-CMDeviceCollection
• Clientbenachrichtigungen