Export (0) Print
Expand All
Expand Minimize

Start-DPMLibraryInventory

Updated: November 1, 2013

Applies To: System Center 2012 R2 Data Protection Manager

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.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DPMLibrary<Library>

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


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-FastInventory

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-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.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Tape<Media[]>

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before executing the command.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

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

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

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft