New-AppLibPackageDiscovery

Last published : Oct 31, 2026
Starts a new package discovery session running on a VDA chosen from the specified desktop group
Related information
about_AppLibAppLibrarySnapin

Syntax

New-AppLibPackageDiscovery
   -DiscoveryProfileUid <Int32>
   [-LoggingId <Guid>]
   [<CitrixCommonParameters>]
   [<CommonParameters>]
New-AppLibPackageDiscovery
   -DesktopGroupUid <Int32>
   -Path <String>
   [-Recurse <Boolean>]
   [-DiscoverAppV <Boolean>]
   [-DiscoverMsix <Boolean>]
   [-DiscoverAppAttach <Boolean>]
   [-DiscoverFlexApp <Boolean>]
   [-CleanupAbsentPackages <Boolean>]
   [-LoggingId <Guid>]
   [<CitrixCommonParameters>]
   [<CommonParameters>]
New-AppLibPackageDiscovery
   -DesktopGroupUid <Int32>
   -ManagementServer <String>
   -PublishingServer <String>
   [-Username <String>]
   [-Password <SecureString>]
   [-CleanupAbsentPackages <Boolean>]
   [-LoggingId <Guid>]
   [<CitrixCommonParameters>]
   [<CommonParameters>]

Description

A package discovery object has information about the state and progress of the discovery session

Examples

EXAMPLE 1

Initiates a new package discovery session that will discover packages in the specified folder and its subfolder tree
$BrokerDesktopGroup = Get-BrokerDesktopGroup -Name 'Package Discovery Group'
New-AppLibPackageDiscovery -DesktopGroupUid $BrokerDesktopGroup.Uid -Path "\\FileServer.company.com\AppVShare" -Recurse $true

EXAMPLE 2

Initiates a new package discovery session according to the options specified in the stored package discovery profile
$PackageDiscoveryProfile = Get-PackageDiscoveryProfile -Uid 1
New-AppLibPackageDiscovery -DiscoveryProfileUid $PackageDiscoveryProfile.Uid

Parameters

-DiscoveryProfileUid

The Uid of the package discovery profile to use when determining the parameters for the discovery session
Type: Int32
Position: Named
Default value: 0
Required: True
Accept pipeline input: False
Accept wildcard characters: False

-DesktopGroupUid

The Uid of the desktop group from which the broker will select a VDA to run the discovery
Type: Int32
Position: Named
Default value: 0
Required: True
Accept pipeline input: False
Accept wildcard characters: False

-Path

The UNC path of the shared network folder (or file) location where the discovery will start
Type: String
Position: Named
Default value: Null
Required: True
Accept pipeline input: False
Accept wildcard characters: False

-ManagementServer

The URL of the App-V Management Server where the discovery will take place
Type: String
Position: Named
Default value: Null
Required: True
Accept pipeline input: False
Accept wildcard characters: False

-PublishingServer

The URL of the App-V Publishing Server that will be used to publish the discovered packages
Type: String
Position: Named
Default value: Null
Required: True
Accept pipeline input: False
Accept wildcard characters: False

-Recurse

A value indicating whether the discovery will search through the child folder tree from the discovery root.
Type: Boolean
Position: Named
Default value: True
Required: False
Accept pipeline input: False
Accept wildcard characters: False

-DiscoverAppV

A value indicating whether the discovery will include App-V packages
Type: Boolean
Position: Named
Default value: True
Required: False
Accept pipeline input: False
Accept wildcard characters: False

-DiscoverMsix

A value indicating whether the discovery will include Msix packages
Type: Boolean
Position: Named
Default value: False
Required: False
Accept pipeline input: False
Accept wildcard characters: False

-DiscoverAppAttach

A value indicating whether the discovery will include AppAttach packages
Type: Boolean
Position: Named
Default value: False
Required: False
Accept pipeline input: False
Accept wildcard characters: False

-DiscoverFlexApp

A value indicating whether the discovery will include FlexApp packages
Type: Boolean
Position: Named
Default value: False
Required: False
Accept pipeline input: False
Accept wildcard characters: False

-CleanupAbsentPackages

A value indicating whether the discovery should attempt to remove packages from the library that were not present in the discovery location
Type: Boolean
Position: Named
Default value: False
Required: False
Accept pipeline input: False
Accept wildcard characters: False

-Username

The username of the App-V server administrator
Type: String
Position: Named
Default value: Null
Required: False
Accept pipeline input: False
Accept wildcard characters: False

-Password

The password of the App-V server administrator
Type: SecureString
Position: Named
Default value: Null
Required: False
Accept pipeline input: False
Accept wildcard characters: False

-LoggingId

Specifies the identifier of the high-level operation this cmdlet call forms a part of. Citrix Studio and Director typically create high-level operations. PowerShell scripts can also wrap a series of cmdlet calls in a high-level operation by way of the Start-LogHighLevelOperation and Stop-LogHighLevelOperation cmdlets.
Type: Guid
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: False

CitrixCommonParameters

This cmdlet supports the common Citrix parameters: -AdminAddress, -AdminClientIP, -BearerToken, -TraceParent, -TraceState and -VirtualSiteId. For more information, see about_CitrixCommonParameters.

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

You can't pipe objects to this cmdlet.

Outputs

Citrix.AppLibrary.Sdk.PackageDiscovery

Informaton about the discovery session that was initiated

Notes

The discovery root path and a pair of Management and Publishing servers are mutually exclusive. I.e. a discovery session will run against either a network folder or an App-V Management and Publishing server