Skip to main content

Creating a New Distribution System Connection Setting

AdminStudio 2025 R2 | 30.0 | Application Manager

Application Manager is included with AdminStudio Professional and Enterprise Editions.

To create a new named connection to a distribution system, perform the following steps:

To create a new named connection to a distribution system:

  1. On the Application Catalog tab menu, select Options. The Options dialog box opens.

  2. Under Servers Options, select Distribution System. The Distribution System tab opens, and lists all defined connections. ![](/images/New Distribution connection dialog box_1.png)

  3. Click New. A new set of empty connection setting fields is displayed.

  4. In the Name field, enter a name to identify this new named connection to a distribution system.

  5. From the Deployment Type list, select one of the following to identify the distribution system technology of this new named connection:

    • Workspace ONE Distribution Plugin

    • Altiris Distribution Plugin

    • App-V Server Distribution Plugin

    • Casper Distribution Plugin

    • Custom Distribution Plugin

    • Intune Distribution Plugin

    • ConfigMgr Deployment Plugin

    • XenApp Distribution Plugin

  6. In the Server field, enter the name of your distribution system server.

  7. In the Site Code field, enter the code that identifies your distribution system site.

    note

    If you are creating a named connection to a XenApp, Altiris, or App-V server, leave the Site Code field blank. If you are creating a named connection to Casper, this field will not be displayed.

  8. Under Distribution System Authentication, set the Authentication Type field to either Windows Authentication or Server Authentication to identify the authentication type you are going to use to access the specified distribution system. If you selected Server Authentication, you need to also enter a Username and Password.

  9. Under Publish Location Information, set the Authentication Type field to either Windows Authentication or Server Authentication to identify the authentication type you are going to use to access the shared location where you will be publishing packages during distribution. If you selected Server Authentication, you need to also enter a Username and Password.

  10. (Casper only) In the Distribution Point field, enter the Casper distribution point you want to distribute packages to.

    note

    Casper supports multiple server infrastructures, but AdminStudio only supports the File Share Distribution Points infrastructure, and copies packages to a UNC File Share Distribution Point in Casper. AdminStudio currently does not support copying packages to JDS Instances, Cloud Distribution Points, Software Update Servers, or NetBoot Servers.

  11. (Custom Distribution Plugin only) Under Script Information:

    • In the Script File field, click Browse and select the script file (.ps1) that you want to add. This is an optional field.

      note

      It is required that the specified PowerShell script file must be present in the AdminStudio installed machine.

    note

    The specified PowerShell script file will be executed locally on the AdminStudio installed machine during publish.

    • In the Script Parameters, enter the parameters used in the PowerShell script with the appropriate AdminStudio placeholders. This is an optional field.

    • The Script Parameters field must be used to pass the AdminStudio placeholders value to the parameters in the PowerShell script file. During the execution of the script, AdminStudio will replace the specified parameters with the value of the placeholders for the package being published. The below Table lists all supported AdminStudio placeholders with their values.

  • Workspace ONE Distribution Plugin

    PlaceholdersValues
    [ProductName]Name of the application node as it appears in the Application tree in the Catalog.
    [Vendor]Value of the Manufacturer property in the Package Information tab.
    [Version]Value of the Software Version property in the Package Information tab.
    [PackagePublishPath]Path to the package file after the copy.
    [InstallCmdLine]Value of the Install command line property in the Programs tab under Deployment Data tab.
    [UnInstallCmdLine]Value of the Uninstall command line property in the Programs tab under Deployment Data tab.
    [Platform]Operating system platform supported by the package.
    [RepairCommandLine]Value of the Repair command line property in the Programs tab under Deployment Data tab.
    [Language]Value of the Language property in the Package Information tab.
    [PackagePublishFolder]Path to the folder where the package copied during publish.
    [TransformFilePath]Value of the Transforms property in the Package Information tab.
    [IconPath]Value of the Icon file property in the General Information tab.
    [SetupType]Package type extension. For Examples: MSI, EXE, etc
    note

    Enter the script parameters in comma-separated format with no gap:

note

For Example: -ProductName [ProductName],-Vendor [Vendor],-Version [Version]

note

If you use any other delimiter than comma, an error message will be generated.

  1. (ConfigMgr Distribution Plugin only) Under Script Information:

    • In the Script File field, click Browse and select the script file (.ps1) that you want to add. This is an optional field.

      note

      It is required that the specified PowerShell script file must be accessible for the AdminStudio installed machine.

    note

    The specified PowerShell script file will be executed on ConfigMgr system after application is published.

    • In the Script Parameters, enter the parameters used in the PowerShell script with the appropriate AdminStudio placeholders. This is an optional field.

    • The Script Parameters field must be used to pass the AdminStudio placeholders value to the parameters in the PowerShell script file. During the execution of the script, AdminStudio will replace the specified parameters with the value of the placeholders for the package being published. The below Table lists all supported AdminStudio placeholders with their values.

      PlaceholdersValues
      [ProductName]Name of the application node as it appears in the Application tree in the Catalog.
      [Vendor]Value of the Manufacturer property in the Package Information tab.
      [Version]Value of the Software Version property in the Package Information tab.
      [PackagePublishPath]Path to the package file after the copy.
      [InstallCmdLine]Value of the Install command line property in the Programs tab under Deployment Data tab.
      [UnInstallCmdLine]Value of the Uninstall command line property in the Programs tab under Deployment Data tab.
      [Platform]Operating system platform supported by the package.
      [RepairCommandLine]Value of the Repair command line property in the Programs tab under Deployment Data tab.
      [Language]Value of the Language property in the Package Information tab.
      [PackagePublishFolder]Path to the folder where the package copied during publish.
      [TransformFilePath]Value of the Transforms property in the Package Information tab.
      [IconPath]Value of the Icon file property in the General Information tab.
      [SetupType]Package type extension. For Examples: MSI, EXE, etc
    note

    Enter the script parameters in comma-separated format with no gap:

note

For Example: -ProductName [ProductName],-Vendor [Vendor],-Version [Version]

note

If you use any other delimiter than comma, an error message will be generated.

  1. (ConfigMgr Distribution Plugin only) Under Script Information:

    • In the Script File field, click Browse and select the script file (.ps1) that you want to add. This is an optional field.

      note

      It is required that the specified PowerShell script file must be accessible for the AdminStudio installed machine.

    note

    The specified PowerShell script file will be executed on ConfigMgr system after application is published.

    • In the Script Parameters, enter the parameters used in the PowerShell script with the appropriate AdminStudio placeholders. This is an optional field.

    • The Script Parameters field must be used to pass the AdminStudio placeholders value to the parameters in the PowerShell script file. During the execution of the script, AdminStudio will replace the specified parameters with the value of the placeholders for the package being published. The below Table lists all supported AdminStudio placeholders with their values.

      note

      The Custom Distribution Plugin can be used to publish applications to an endpoint management system that is not supported out-of-the-box by AdminStudio. During publish to a Custom Distribution System, the selected package will be first copied to the shared path specified in the Location to Publish Packages field, and then the PowerShell script file specified in the Script File field will be executed. The PowerShell script can perform any action, which may include importing of the copied package into any end point management system.

  2. If you want to add another named connection, click New and repeat the above process.

  3. Click OK to close the dialog box.

See Also

Server Options / Distribution System Tab