Start-DPMLibraryRescan
Starts a scan to identify new libraries and update existing libraries.
Syntax
Full (Default)
Start-DPMLibraryRescan
[[-DPMServerName] <String>]
[-Full]
[-JobStateChangedEventHandler <JobStateChangedEventHandler>]
[<CommonParameters>]
Quick
Start-DPMLibraryRescan
[[-DPMServerName] <String>]
[-Quick]
[-JobStateChangedEventHandler <JobStateChangedEventHandler>]
[<CommonParameters>]
RefreshOnly
Start-DPMLibraryRescan
[[-DPMServerName] <String>]
[-RefreshOnly]
[-JobStateChangedEventHandler <JobStateChangedEventHandler>]
[<CommonParameters>]
Description
The Start-DPMLibraryRescan cmdlet starts a scan for a System Center - 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.
Examples
Example 1: Perform a full rescan
PS C:\>Start-DPMLibraryRescan -DPMServerName "DPMServer07" -Full
This command starts a full rescan of the libraries on the DPMserver named DPMServer07.
Parameters
-DPMServerName
Specifies the name of a DPM server that this cmdlet scans.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 1 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-Full
Indicates that the cmdlet starts a full library rescan.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Full
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-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.
Parameter properties
| Type: | JobStateChangedEventHandler |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Handler |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Quick
Indicates that the cmdlet starts a quick library rescan.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Quick
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-RefreshOnly
Indicates that the cmdlet starts a refresh library scan.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
RefreshOnly
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.