다음을 통해 공유


Invoke-CMClientAction

클라이언트 컴퓨터에 알림을 보내 즉각적인 클라이언트 작업을 트리거합니다.

구문

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

Description

Invoke-CMClientAction cmdlet은 클라이언트 컴퓨터에 알림을 보내 즉각적인 클라이언트 작업을 트리거합니다. 하나 이상의 클라이언트 컴퓨터를 지정하거나 지정된 디바이스 컬렉션의 모든 컴퓨터에 알림을 보낼 수 있습니다.

이러한 작업에 대한 자세한 내용은 클라이언트 알림을 참조하세요.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.

예제

예제 1: 디바이스 절 해제

다음 예제에서는 절식 작업을 특정 컬렉션의 디바이스로 보냅니다.

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

예제 2: 디바이스에서 컴퓨터 정책 요청

이 명령은 라는 디바이스Computer073에 형식 RequestMachinePolicyNow 의 알림을 보냅니다.

Invoke-CMClientAction -DeviceName "Computer073" -NotificationType RequestMachinePolicyNow

매개 변수

-ActionType

클라이언트에 보낼 작업 키워드를 지정합니다. 컴퓨터 또는 사용자 정책을 요청하려면 -NotificationType 매개 변수를 사용합니다.

형식:ClientActionType
허용되는 값: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
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Collection

대상으로 지정할 컬렉션 개체를 지정합니다.

형식:IResultObject
별칭:DeviceCollection
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-CollectionId

대상으로 지정할 ID별 컬렉션을 지정합니다.

형식:String
별칭:DeviceCollectionId
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-CollectionName

대상으로 지정할 이름으로 컬렉션을 지정합니다.

형식:String
별칭:DeviceCollectionName
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Device

대상으로 지정할 디바이스 개체를 지정합니다.

형식:IResultObject
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-DeviceId

대상으로 지정할 디바이스를 ID로 지정합니다.

형식:String
별칭:ResourceId
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DeviceName

대상으로 지정할 디바이스를 이름으로 지정합니다.

형식:String
별칭:Name
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DisableWildcardHandling

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ForceWildcardHandling

이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-NotificationType

클라이언트에서 컴퓨터 또는 사용자 정책을 요청합니다. 다른 모든 작업을 트리거하려면 -ActionType 매개 변수를 사용합니다.

형식:ClientNotificationType
허용되는 값:RequestMachinePolicyNow, RequestUsersPolicyNow
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ParentCollection

이 매개 변수를 사용하여 컴퓨터 절전 모드 해제를 지원합니다.

형식:IResultObject
별칭:ParentDeviceCollection
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ParentCollectionId

이 매개 변수를 사용하여 컴퓨터 절전 모드 해제를 지원합니다.

형식:String
별칭:ParentDeviceCollectionId
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ParentCollectionName

이 매개 변수를 사용하여 컴퓨터 절전 모드 해제를 지원합니다.

형식:String
별칭:ParentDeviceCollectionName
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet을 실행하지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

System.Object

참고

Cmdlet 별칭: Invoke-CMClientNotification