Start-DPMLibraryInventory

Start-DPMLibraryInventory

Starts an inventory of tapes in a DPM library.

Syntax

Parameter Set: FastInventory
Start-DPMLibraryInventory [-DPMLibrary] <Library> [-FastInventory] [-JobStateChangedEventHandler <JobStateChangedEventHandler> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: DetailedInventory
Start-DPMLibraryInventory [-DPMLibrary] <Library> -DetailedInventory [-JobStateChangedEventHandler <JobStateChangedEventHandler> ] [-Tape <Media[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Start-DPMLibraryInventory cmdlet starts an inventory of the tapes in a System Center 2012 – Data Protection Manager (DPM) library. DPM detects any tape, with or without a bar code, in a library. You can choose either a detailed inventory or a fast inventory.

For a detailed inventory, DPM reads the header area of the tapes in a library to identify the on-media identifier (OMID) on each tape.

For a fast inventory of a library that has a bar code reader, DPM reads the bar code of each tape in the library. If a library does not have a bar code reader or a tape does not have a bar code, DPM reads the header area of the tapes to identify the OMID.

Parameters

-DetailedInventory

Indicates that DPM performs a detailed inventory on the specified library.

-DPMLibrary<Library>

Specifies a DPM library object. To obtain a DPM library object, use the Get-DPMLibrary cmdlet.

-FastInventory

Indicates that DPM performs a fast inventory on the specified library.

-JobStateChangedEventHandler<JobStateChangedEventHandler>

Specifies an event handler for Job.StateChanged events. You can use this parameter to update a GUI that runs in Windows PowerShell, but do not use it in the Windows PowerShell console.

-Tape<Media[]>

Specifies an array of tape objects. To obtain a tape object, use the Get-DPMTape cmdlet.

-Confirm

Prompts you for confirmation before running the cmdlet.

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

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

Outputs

The output type is the type of the objects that the cmdlet emits.

• Job

Notes

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

Examples

Example 1: Perform a fast inventory

This example performs a fast inventory on a tape library for the DPM server named DPMServer07. The first command uses the Get-DPMLibrary cmdlet to get the library associated with the server, and stores that object in the $DPMLib variable.

The second command starts an inventory on the library object stored in the $DPMLib variable. The command uses the FastInventory parameter, so the command starts a fast inventory.

PS C:\> $DPMLib = Get-DPMLibrary -DPMServerName "DPMServer07"
PS C:\> Start-DPMLibraryInventory -DPMLibrary $DPMLib -FastInventory

Example 2: Perform a detailed inventory

This example performs a detailed inventory on a tape library for the DPM server named DPMServer07. The first command uses the Get-DPMLibrary cmdlet to get the library associated with the server, and stores that object in the $DPMLib variable.

The second command starts an inventory on the library object stored in the $DPMLib variable. The command uses the DetailedInventory parameter, so the command starts a detailed inventory.

PS C:\> $DPMLib = Get-DPMLibrary -DPMServerName "DPMServer07"
PS C:\> Start-DPMLibraryInventory -DPMLibrary $DPMLib -DetailedInventory

Related topics

Get-DPMLibrary

Get-DPMTape