Use the Get-DominoApplication cmdlet to retrieve metadata from Domino applications.

Get-DominoApplication [-SourceIdentity <String>] [-DominoServer <String>] [-Exclude <String>] [-ExcludeAcls <SwitchParameter>] [-MatchToTarget <SwitchParameter>] [-MaxThreadCount <UInt32>] [-NotesIniPath <String>] [-Quiet <SwitchParameter>] [-SourceCredential <PSCredential>] [-SourceDetail <String>] [-SourceMapping <String>]

Parameters

Parameter Required Type Description

DominoServer

Optional

System.String

Hierarchical name of the Lotus Domino server where the source application is located.

For example, Server01/Contoso.

Exclude

Optional

System.String

Identifies which applications should be excluded when retrieving application information. By default, Mail and Administration applications (such as admin4.nsf, busytime.nsf, events4.nsf) are excluded.

ExcludeAcls

Optional

System.Management.Automation.SwitchParameter

Prevents ACLs from migrating.

MatchToTarget

Optional

System.Management.Automation.SwitchParameter

Matches Notes usernames to Active Directory Accounts when migrating Access Control Lists (ACLs).

MaxThreadCount

Optional

System.UInt32

Maximum number of threads allocated to this task.

NotesIniPath

Optional

System.String

Path to local Notes.INI file including filename.

SourceCredential

Optional

System.Management.Automation.PSCredential

Unique name for the Domino user.

GUID, user's hierarchical name, user's canonical name, or user's SMTP address.

SourceDetail

Optional

System.String

Defines level of detail retrieved for the application.

Levels include:

  • 0 returns application information from the DatabaseCatalog

  • 1 returns additional information such as forms, fields and views and matches ACL entries with Active Directory accounts. Identifies mail routing options (@functions and LotusScript)

  • 2 returns additional information such as the code (@functions, LotusScript, for example.) for the application.

SourceIdentity

Optional

System.String

Used to specify a specific Domino application whose information should be retrieved.

List path and filename relative to the Domino data directory.

For example, \Sales\CustInfo.nsf.

SourceMapping

Optional

System.String

Specifies a custom mapfile that defines how the attributes in the object schema will be mapped from the source schema.

Quiet

Optional

System.Management.Automation.SwitchParameter

Suppresses feedback during task actions.

Detailed Description

The Get-DominoApplication cmdlet retrieves metadata for Domino applications from the Domino Database Catalog or directly from each Domino application.

To run the Get-DominoApplication cmdlet, the account you use must have Read rights to Active Directory directory service and Reader access in each Domino application's access control list (ACL).

Input Types

None.

Return Types

AlienDataObject.

Example

The first example returns any application with "Demo" in the application title. The second example returns applications that are mail-enabled and displays only the application title ("Sales Demonstration Samples") and the application filename.

  Copy Code
Get-DominoApplication –SourceDetail 1 | Where {$_.uniquename –iLike “*Demo”} | Format-List Name, UniqueName 

Get-DominoApplication –SourceDetail 1 | Where {($_.MailEnabled –eq $True) AND  –and ($_.UniqueName –iLike “Sales Demonstration Samples”)} |  Sort-Object Name –Descending | Format-List Name, UniqueName