Conditions enable you to set products to download and install on your device only when preset conditions are met. Create a condition to determine when a product downloads and installs onto your devices.

To create a condition, follow the steps listed below:

  1. Navigate to Devices > Staging & Provisioning > Components > Conditions and select Add Condition.

  2. Select the Platform you want to create a staging configuration for.

  3. Complete the Condition Information fields:

    Settings Description
    Name Enter a name for the condition. The name cannot be longer than 255 characters.
    Description Enter a description for the condition.
    Condition Type

    The type of condition affects the parameters on the Condition Details tab.

    • Adapter Time
    • Adapter
    • Confirm
    • Power
    • Time
    • SD Card Encryption
    • Sc h edule
    • File
    Managed By Select the organization group that manages the condition.
  4. Select Next.
  5. Complete the Condition Details field based on the condition type chosen above:

    • Adapter Time – This condition type tests for various combinations of constraints related to Network Adapters and local date and time on the device.

      Settings Description
      Specify Scenario #1

      Set to Specify this scenario to begin configuring the condition scenario.

      Up to 5 scenarios may be entered, each with their own constrain choices.

      Each Scenario is an OR statement and each option inside a Scenario is an AND statement. For example, a device will check to see if Scenario #1 OR Scenario #2 is true. If Scenario #1 is true, it will check if all the constraints listed are true because they are AND statements.

      Constrain Network Adapters

      Set to Constrain based on the Best Connected Network Adapter and configure the following:

      • Specify any Included or Excluded Network Adapters.
      • Choose to either Select Network Adapter Class from a drop-down list or Type in an adapter name.
      • Up to five network adapters may be included or excluded.
      Constrain Days of Week For each day of the week, choose whether it will be included or excluded.
      Constrain Months For each month, choose whether it will be included or excluded.
      Constrain Days of Month Enter a Start Day of Month and an End Day of Month.
      Constrain Years Enter a Start Year and an End Year.
      Set a Frequency Limit

      Ranges from Every 15 Minutes to Every 1 Week.

      Set frequency limit?

      Ranges from Every 15 Minutes to Every 1 Week.

      Set frequency limit is a mandatory setting. The Adapter Time condition will not function correctly without it.

    • Adapter –This condition type tests to see which, if any, Network Adapters are connected. This can be highly relevant if network connectivity is a scarce or expensive resource and certain operations should be limited to use over certain Network Adapters or prohibited from use over certain Network Adapters.

      Settings

      Descriptions
      Exclude Adapters

      Choose to exclude adapters or not.

      • If False is entered, the adapters selected in the following steps are included in the condition.
      • If True is entered, the adapters selected in the following steps are excluded in the condition.

      AirWatch strongly recommends using the Adapter Time condition instead of the Adapter condition as support for the Adapter condition has been deprecated and may be withdrawn completely.

      Select Adapter from List?

      Choose to select an adapter from the list or not.

      If False is entered, the Select Adapter list changes to a field to enter Adapter Name.

      Select Adapter Select the network adapter from the drop down list.
      Adapter Name Enter the adapter name to exclude.
      Specify Second/Third adapter? Choose to exclude additional adapters.
    • Confirm – This condition type prompts the end user to determine whether or not the condition is met. This prompt is customizable so you can control what displays on the prompt.

      Settings Description
      First Line Prompt

      Enter a header of the prompt

      Second Line Prompt

      Enter the body of the prompt.

      Enter the subheading of the prompt (macOS Only).

      Third Line Prompt

      If you enable a countdown, you can enter a countdown phrase into the Third Line Prompt field.

      For example, "You have %count% seconds to comply" where %count% is the countdown clock.

      Enter the body of the prompt into the Third Line Prompt (Mac OSX Only).

      Prod_Prov_MacOSX_Confirm

      Delay (seconds) Use this to delay for a specified time or until the end user makes a selection. If you enter a non-zero value, the prompt will wait for that value worth of seconds. Then if the end user does not make a selection in the time allowed, the condition is automatically considered not met. If a value of zero is entered, then the prompt will display indefinitely until the end user makes a selection.
      Enable Countdown This allows delay time to be “counted” down on the device so the end user knows how much time is remaining for the user to make a selection.
      Enable Cancel Enable to provide a cancel button to the prompt.
      Defer Time (seconds) This controls the minimum time after the condition is not met before the end user will be prompted again to determine the state of this condition. If a non-zero value is entered, the end user will not be prompted again for at least that number of seconds. If a value of zero is entered, then the end user could be prompted again as soon as the next execution of the Check-In command.
      Maximum Number of Defers This controls the maximum number of times the condition is not met. Once the condition has not been met this number of times, it will either be met or failed, depending on the setting of the next feature. If a value of zero is entered, then the condition will be met or failed on the first time.
      Action after Maximum Defers

      Select the action to trigger after the maximum number of defers is met:

      • Fail Condition
      • Display Cancel Button
      • Pass Condition
    • Power – This condition type tests how a device is being powered, including whether the device is plugged in or has a suitably high battery level. Use a Power condition type to prompt users to place the device into the cradle or to insert a charged replacement battery.

      Settings Description
      First Line Prompt

      Enter a header for the prompt.

      Second Line Prompt Enter the body of the prompt
      Third Line Prompt

      If you enable a countdown, you can enter a countdown phrase into the Third Line Prompt field.

      For example, "You have %count% seconds to comply" where %count% will be the countdown clock.

      Delay (seconds) Use this to delay for a specified time or until the end user makes a selection. If you enter a non-zero value, the prompt will wait for that value worth of seconds. If the end user does not make a selection in the time allowed, the condition is automatically considered not met. If a value of zero is entered, then the prompt will display indefinitely until the end user makes a selection.
      Enable Countdown This allows delay time to be “counted” down on the device so the end user knows how much time is remaining for the user to make a selection.
      Required Power Level

      Enter the required power level for the condition to test true:

      • A/C
      • A/C or Full Battery
    • Time – This condition type tests the local date and time on a device.

      AirWatch strongly recommends using the Adapter Time condition instead of the Time condition as support for the Time condition has been deprecated and may be withdrawn completely.

      Settings Description
      Month

      Select Don't Care to ignore or choose the specific start time month.

      Day Select Don't Care to ignore or choose the start time specific year.
      Hour Select Don't Care to ignore or choose the start time specific hour.
      Minute Select Don't Care to ignore or choose the start time specific minute.
      Month Select Don't Care to ignore or choose the end time specific month.
      Day Select Don't Care to ignore or choose the end time specific year.
      Hour Select Don't Care to ignore or choose the end time specific hour.
      Minute Select Don't Care to ignore or choose the end time specific minute.
      Enable Time Check 2/3? Set to True to set additional time checks.
    • SD Encryption – This condition type tests whether the device is encrypted or not encrypted. This can be highly relevant if you need to wait for the device to be encrypted before downloading a file to it.

      Settings Description
      Encryption State

      Select Encrypted or Unencrypted to limit the product based on the state of the device encryption.

    • Schedule – This condition type tests the device date and time against a specific date/time entered. When the date/time is met, the condition passes and allows the download.

      Settings Description
      Month

      Enter the specific month.

      Day Enter the specific day.
      Year Enter the specific year.
      Hour Enter the specific hour.
      Minute Enter the specific minute.
    • File – This condition type tests the device to see if a file is present or not. You can set the condition to test if the file is on the device, and if it is, test true. You may also set the condition to test true is a file is not on the device. Finally, you may set the condition to create a flag file and save it on the device for use with third-party programs.

      Settings Description
      Specify Flag File

      Set to Specify Flag File to enable the use of a flag file for use with third-party programs.

      Specify Flag file Location Enter a location path for the flag file.
      Specify Flag File Contents Enter the content you want in the flag file.
      Specify Scenario #1? Set to Specify this scenario to enable testing a file's existence on the device.
      Test File

      Enter the name of the test file the condition tests.

      Test Type Choose to test whether to test if the File Exists or if the File Does Not Exist.
      Remove File Choose to either Remove File or Do Not Remove File when the test completes.
  6. Select Finish.
  7. View the newly created condition in the List View. Take additional actions on the profile from the menus on the right:
    • Edit your condition.
    • Copy your condition.
    • Delete your condition.