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.

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 changes in the status of a job. 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

-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

Notes

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

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