Skip to main content

listadresources

Use the listadresources program to list network resources (shares, printers, mail distribution lists) in a Microsoft Active Directory domain .

You can then use the resulting output file with the loadnetres program to import the resources into Bravura Security Fabric .

Usage

listadresources -hostid <target ID> -outfile <filename> [-validateperm]

Option

Description

-hostid <target ID>

The target ID of the Active Directory domain in Bravura Security Fabric.

-outfile <filename>

The output filename.

-validateperm

Determines the value of the Users are only allowed to see sub-resources when they read permission for a resource checkbox for a share/folder resource. Including this option sets -validateperm to true. If unspecified, the value is false; the default value is false.

Output file format

The output file format for listadresources is the same as the input file format for loadnetres.

The file is written in KVGroup format:

"" "" = {
  "<resource type>" "<publish name>"= {           # required
    "Address" = "<UNC path of the resource>"        # required for shares and printers
    "TargetId" = "<target ID>"                       # required
    "Description" = "<description>"  # not required
    "ValidatePermissions" = "<true|false>"          # not required
  }
 ...   # You can specify multiple KVGroups, one for each resource.
}

The <resource type> is one of:

  • F – share/folder resource

  • M – mail distribution list

  • P – printer resource

ValidatePermissions determines the value of the Users are only allowed to see sub-resources when they have read permission for a resource checkbox for a share/folder resource. The default is false.

Example

The following is an example of the file format:

# KVGROUP-V1.0
"" "" = {
  "F" "share1" = {
    "Address" = "\\\\10.0.26.115\\share1"
    "Description" = "A shared folder"
    "TargetId" = "ADDOM"
  }
  "M" "AllSalesGroup" = {
    "Description" = "Distribution list for sales"
    "TargetId" = "ADDOM"
  }
  "P" "COMPUTERNAME-Printer1" = {
    "Address" = "\\\\computername.example.com\\Printer1"
    "Description" = "First floor printer"
    "TargetId" = "ADDOM"
  }
  "F" "share2" = {
    "Address" = "\\\\10.0.26.115\\share2"
    "Description" = "Another shared folder"
    "TargetId" = "ADDOM"
    "ValidatePermissions" = "true"
  }
}