Start-DPMLibraryInventory

Start-DPMLibraryInventory

Starts an inventory of the tape in the specified library.

Syntax

Start-DPMLibraryInventory [-DPMLibrary] <Library> -DetailedInventory [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [-Tape <Media>] [<CommonParameters>]


Start-DPMLibraryInventory [-DPMLibrary] <Library> [-FastInventory] [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [<CommonParameters>]

Detailed Description

The Start-DPMLibraryInventory cmdlet starts an inventory of the tape in the specified library.

You must specify the FastInventory parameter if you do not want detailed inventory to be performed.

Parameters

-DPMLibrary

A DPM library object.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

true (ByValue)

Position?

0

-DetailedInventory

Indicates that a detailed inventory must be performed on the specified library. A detailed inventory will mount and read the header of the tape.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-FastInventory

Indicates that a fast inventory must be performed on the specified library. A fast inventory will not read the headers from the tape.

Attributes

Name Value

Required?

false

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-JobStateChangedEventHandler

The JobStateChangedEventHandler is used along with the -Async parameter so that the user can be informed of the status of the operation. This is useful when building a GUI using cmdlets. It is not used when working with the DPM Management Shell.

Attributes

Name Value

Required?

false

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-Tape

Indicates a tape object.

Attributes

Name Value

Required?

false

Accept wildcard characters?

false

Accept Pipeline Input?

true (ByValue)

Position?

named

-CommonParameter

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

Input and Return Types

The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet emits.

Notes

  • For more information, type "Get-Help Start-DPMLibraryInventory -detailed".
    For technical information, type "Get-Help Start-DPMLibraryInventory -full".

    Additionally, any updated information about the cmdlet will be available at https://go.microsoft.com/fwlink/?LinkId=95130.

Examples

EXAMPLE 1

$DPMLib = Get-DPMLibrary -DPMServerName "TestingServer" 
Start-DPMLibraryInventory -DPMLibrary $DPMLib -FastInventory

This command performs a fast inventory of the library on the TestingServer.

EXAMPLE 2

$DPMLib = Get-DPMLibrary -DPMServerName "TestingServer" 
Start-DPMLibraryInventory -DPMLibrary $DPMLib -DetailedInventory

This command performs a detailed inventory of the library on TestingServer.