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