New-ASDistributionConnectionEx
AdminStudio 2024 | 27.0
Note:Starting in AdminStudio 2020, New-ASDistributionConnection is obsolete and New-ASDistributionConnectionEx should used instead.
AdminStudio has a generic platform API, New-ASDistributionConnectionEx, to support creating distribution connections.It accepts XML as an input parameter.
Example
New-ASDistributionConnectionEx -XmlPath "C:\test data\ConfigMgr.xml"
Example XML Input Files
The following are examples of XML input files for different distribution platforms:
| • | Configuration Manager |
| • | Intune |
| • | WorkSpace ONE |
| • | Altiris |
| • | Microsoft AppV Server |
| • | Citrix XenApp |
Note:ShareFolderPath can be given with placeholders for the specified distribution system. Supported placeholder include: ProductName, Vendor, Version, SetupType, Platform, and Language.
<?xml version="1.0" encoding="utf-8" ?>
<ConfigMgr>
<DistributionInformation>
<PluginId>EDFBE09C-E305-4ABF-BEEB-77032335ACB7</PluginId>
<Name></Name>
<Server></Server>
<SiteCode></SiteCode>
</DistributionInformation>
<DistributionSystemAuthentication>
<UseWindowsAuthentication>
true
</UseWindowsAuthentication>
<UserName></UserName>
<Password></Password>
</DistributionSystemAuthentication>
<ScriptInformation>
<ScriptFile>path of PS1 file</ScriptFile>
<ScriptParameters>-ServerName [Server],-Site [SiteCode],-ProductName [ProductName],-Version [Version],-Vendor [Vendor],-SetupType [SetupType],-language [Language],-Install [InstallCmdLine],-UnInstall [UnInstallCmdLine],-Platform [Platform],-Icon [IconPath],-PublishFolder [PackagePublishFolder],-Transform [TransformFilePath],-PublishPath [PackagePublishPath],-Repair [RepairCommandLine]
</ScriptParameters>
</ScriptInformation>
<ShareInformation>
<UseWindowsAuthentication>
true
</UseWindowsAuthentication>
<UserName></UserName>
<Password></Password>
<ShareFolderPath></ShareFolderPath>
</ShareInformation>
</ConfigMgr>
Note:The UseClientSecret switch is false by default.
<?xml version="1.0" encoding="utf-8" ?>
<Intune>
<PluginId>E36D3170-FBEA-4288-9A30-34313599D9DE</PluginId>
<Name></Name>
<UseClientSecret>False</UseClientSecret>
<ClientId></ClientId>
<TenantIdOrTenantName></TenantIdOrTenantName>
<ClientSecret></ClientSecret>
</Intune>
<?xml version="1.0" encoding="utf-8" ?>
<WorkspaceONE>
<DistributionInformation>
<PluginId>F9A0BED5-1B8F-4D1E-BF6C-C724D083BFC7</PluginId>
<Name></Name>
<Server></Server>
<SiteCode></SiteCode>
</DistributionInformation>
<DistributionSystemAuthentication>
<UseWindowsAuthentication>
false
</UseWindowsAuthentication>
<UserName></UserName>
<Password></Password>
</DistributionSystemAuthentication>
</WorkspaceONE>
<?xml version="1.0" encoding="utf-8" ?>
<Altiris>
<DistributionInformation>
<PluginId>DD86877B-D338-490A-B579-93DFB09B71AE</PluginId>
<Name></Name>
<Server></Server>
<SiteCode></SiteCode>
</DistributionInformation>
<DistributionSystemAuthentication>
<UseWindowsAuthentication>
true
</UseWindowsAuthentication>
<UserName></UserName>
<Password></Password>
</DistributionSystemAuthentication>
<ShareInformation>
<UseWindowsAuthentication>
true
</UseWindowsAuthentication>
<UserName></UserName>
<Password></Password>
<ShareFolderPath></ShareFolderPath>
</ShareInformation>
</Altiris>
<?xml version="1.0" encoding="utf-8" ?>
<AppVServer>
<DistributionInformation>
<PluginId>FE347079-E08D-4782-9557-9B21BCD0FE8A</PluginId>
<Name></Name>
<Server></Server>
<SiteCode></SiteCode>
</DistributionInformation>
<DistributionSystemAuthentication>
<UseWindowsAuthentication>
true
</UseWindowsAuthentication>
<UserName></UserName>
<Password></Password>
</DistributionSystemAuthentication>
<ShareInformation>
<UseWindowsAuthentication>
true
</UseWindowsAuthentication>
<UserName></UserName>
<Password></Password>
<ShareFolderPath></ShareFolderPath>
</ShareInformation>
</AppVServer>
<?xml version="1.0" encoding="utf-8" ?>
<XenApp>
<DistributionInformation>
<PluginId>D8F3EF54-D321-4A5E-A08F-18F5689D829A</PluginId>
<Name></Name>
<Server></Server>
<SiteCode></SiteCode>
</DistributionInformation>
<DistributionSystemAuthentication>
<UseWindowsAuthentication>
true
</UseWindowsAuthentication>
<UserName></UserName>
<Password></Password>
</DistributionSystemAuthentication>
<ShareInformation>
<UseWindowsAuthentication>
true
</UseWindowsAuthentication>
<UserName></UserName>
<Password></Password>
<ShareFolderPath>/ShareFolderPath>
</ShareInformation>
</XenApp>
Example XML Template for Configuration Manager
The following is an example of how a populated template for Configuration Manager would look like.
<?xml version="1.0" encoding="utf-8" ?>
<ConfigMgr>
<DistributionInformation>
<PluginId>EDFBE09C-E305-4ABF-BEEB-77032335ACB7</PluginId>
<Name>CMServer</Name>
<Server>10.80.150.234</Server>
<SiteCode>CM5</SiteCode>
</DistributionInformation>
<DistributionSystemAuthentication>
<UseWindowsAuthentication>
false
</UseWindowsAuthentication>
<UserName>ar\administrator</UserName>
<Password>password</Password>
</DistributionSystemAuthentication>
<ShareInformation>
<UseWindowsAuthentication>
false
</UseWindowsAuthentication>
<UserName>ar\administrator</UserName>
<Password>password</Password>
<ShareFolderPath>\\10.80.150.234\Publish</ShareFolderPath>
</ShareInformation>
</ConfigMgr>
Note:Though AdminStudio supports Casper distribution server and a connection to the same can be created from the Application Manager user interface, creating a connection to Casper using AdminStudio PowerShell APIs aren't supported.