New-ASDistributionConnection
info
Starting with AdminStudio 2020, the New-ASDistributionConnection cmdlet is obsolete. You should instead use New-ASDistributionConnectionEx.
You can use the New-ASDistributionConnection cmdlet to use PowerShell to define named connections to ConfigMgr (Formerly called as System Center Configuration Manager), Citrix XenApp Server, Symantec Altiris Management Server, and Workspace ONE Server distribution systems. This enables you to refer to those connection settings by name in AdminStudio PowerShell Cmdlets cmdlets.
Example
New-ASDistributionConnection
-Name SCCM2012
-PluginID 0
-ServerAddress 172.01.02.03
-SiteCode ABC
-DistributionWindowsAuthentication 0
-DistributionUser MyDomain\UserName
-DistributionPassword Password123
-ShareWindowsAuthentication 0
-SharePath \\172.01.02.03\SharedLocation
-ShareUserName MyDomain\UserName
-SharePassword Passw0rd123
Parameters
The New-ASDistributionConnection cmdlet has the following parameters:
| Parameter | Description |
|---|---|
| Name | Use to specify the name of this new named connection to a distribution system. |
| PluginID | Use to specify the plug-in with which the distribution system is associated. This parameter is mapped to the object identifier (OID) of the ASCMSupportedPackageTypes database table; you can provide any value available in this table to identify the plug-in. |
| ServerAddress | Use to specify the distribution server address. |
| SiteCode | When connecting to a ConfigMgr (Formerly called as System Center Configuration Manager) distribution system, use to specify the site code. |
| DistributionWindowsAuthentication | Use to specify whether the distribution connection should use Windows Authentication or a custom user name and password. Available options are: 0 = Do not use Windows Authentication 1 = Use Windows Authentication |
| [DistributionUser] | If not using Windows Authentication, use this parameter to specify the user name to use when connecting to the distribution system. |
| [DistributionPassword] | If not using Windows Authentication, use this parameter to specify the password to use when connecting to the distribution system. |
| SharePath | Use to specify the path to which packages are published. |
| ShareWindowsAuthentication | Use to specify whether the share path should use Windows Authentication or a custom user name and password. Available options are: 0 = Do not use Windows Authentication 1 = Use Windows Authentication |
| [ShareUserName] | If not using Windows Authentication, use this parameter to specify the user name to use when connecting to the share path. |
| [SharePassword] | If not using Windows Authentication, use this parameter to specify the password to use when connecting to the share path. |
Return Values
No values are returned.