Start-DPMLibraryRescan

Start-DPMLibraryRescan

Starts a scan to identify new libraries and update existing libraries.

Syntax

Parameter Set: Full
Start-DPMLibraryRescan [[-DPMServerName] <String> ] [-Full] [-JobStateChangedEventHandler <JobStateChangedEventHandler> ] [ <CommonParameters>]

Parameter Set: Quick
Start-DPMLibraryRescan [[-DPMServerName] <String> ] -Quick [-JobStateChangedEventHandler <JobStateChangedEventHandler> ] [ <CommonParameters>]

Parameter Set: RefreshOnly
Start-DPMLibraryRescan [[-DPMServerName] <String> ] -RefreshOnly [-JobStateChangedEventHandler <JobStateChangedEventHandler> ] [ <CommonParameters>]

Detailed Description

The Start-DPMLibraryRescan cmdlet starts a scan for a System Center 2012 – Data Protection Manager (DPM) server to identify new libraries and stand-alone tape drives, and to update information for existing libraries. You can select one of the following parameters:

-- Full. The cmdlet checks for new libraries and stand-alone tape drives and refreshes all libraries and drives.
-- Quick. The cmdlet checks for new libraries and stand-alone tape drives.
-- RefreshOnly. The cmdlet refreshes known drives.

If you do not specify any of these parameters, the cmdlet performs a full scan.

Parameters

-DPMServerName<String>

Specifies the name of a DPM server that this cmdlet scans.

Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Full

Indicates that the cmdlet starts a full library rescan.

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. Use this parameter to build a graphical user interface based on cmdlets. Do not use this parameter in the DPM Management Shell.

Aliases

Handler

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Quick

Indicates that the cmdlet starts a quick library rescan.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RefreshOnly

Indicates that the cmdlet starts a refresh library scan.

Aliases

none

Required?

true

Position?

named

Default Value

none

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

Examples

Example 1: Perform a full rescan

This command starts a full rescan of the libraries on the DPMserver named DPMServer07.

PS C:\> Start-DPMLibraryRescan -DPMServerName "DPMServer07" -Full