Get-Datasource
Get-Datasource
Retrieves the list of protected and unprotected data in a computer or protection group.
Syntax
Get-Datasource [-ProtectionGroup] <ProtectionGroup> [<CommonParameters>]
Get-Datasource [-ProductionServer] <ProductionServer> [-Async <SwitchParameter>] [-GetVolumesWithoutMountPoints <SwitchParameter>] [-IgnoreDPMInformation <SwitchParameter>] [-Inquire <SwitchParameter>] [-Replica <SwitchParameter>] [-Tag <Object>] [<CommonParameters>]
Get-Datasource [-DPMServerName] <String> [-Inactive <SwitchParameter>] [<CommonParameters>]
Get-Datasource [-SearchPath] <string> [[-ProductionServerName] <string>] [-DPMServerName] <String> [<CommonParameters>]
Get-Datasource [-ComputerNames] <string> [-DPMServerName] <String> [-Async <SwitchParameter>] [<CommonParameters>]
Detailed Description
The Get-Datasource cmdlet retrieves the list of protected and unprotected data on a computer. The output displays only the objects at whose level protection can be done. Use the Get-ChildDatasource cmdlet to see files within the data source.
- Using the Inquire parameter returns all the available data sources on the protected computer.
- Use the DPMServerName parameter with a search string to search for a protected data source on a DPM server.
- Use the Inactive parameter to return all the inactive data sources on a DPM server. An inactive data source is one that is not actively protected on a DPM server.
- Use the ProtectionGroup parameter to return the data sources in a protection group.
Parameters
-ComputerNames
The list of client computers to be added to the protection group.
Attributes
Name | Value |
---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
true (ByValue,ByPropertyName) |
Position? |
1 |
-ProductionServerName
The name of the server being protected.
Attributes
Name | Value |
---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
2 |
-ProductionServer
A server that has a DPM agent installed on it.
Attributes
Name | Value |
---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
true (ByValue,ByPropertyName) |
Position? |
0 |
-SearchPath
The path on which to search for the data source.
Attributes
Name | Value |
---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
1 |
-DPMServerName
The name of a DPM server.
Attributes
Name | Value |
---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
0 |
-ProtectionGroup
The name of a protection group.
Attributes
Name | Value |
---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
true (ByValue,ByPropertyName) |
Position? |
0 |
-Async
Allows the user to indicate that the cmdlet should run asynchronously. This is useful with cmdlets that take a long time to complete. The control returns to the user immediately after the operation starts. The progress of the operation is communicated to the user periodically. This is useful when building a GUI using cmdlets. It is not used when working with the DPM Management Shell.
Attributes
Name | Value |
---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-GetVolumesWithoutMountPoints
Indicates that even volumes without mount points must be retrieved.
Attributes
Name | Value |
---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-IgnoreDPMInformation
Indicates that the cmdlet should not retrieve protected computer information if directed at the primary DPM server.
Attributes
Name | Value |
---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-Inactive
Returns the inactive data sources on a DPM server. An inactive data source is one which was protected at one time, but is not protected currently. The replicas and recovery points of an inactive data source will still be available.
Attributes
Name | Value |
---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-Inquire
Queries the protected computer and returns the list of data sources or child data sources on it.
Attributes
Name | Value |
---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-Replica
Allows the user to indicate whether the space required for a replica on the secondary DPM server should be calculated from the protected computer or the primary DPM server.
Attributes
Name | Value |
---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-Tag
Helps distinguish the replies to each asynchronous call made by a cmdlet. This is useful when building a GUI using cmdlets.
It is not used when working with the DPM Management Shell.
Attributes
Name | Value |
---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-CommonParameter
This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. For more information, see about_CommonParameters.
Input and Return Types
The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet emits.
Notes
For more information, type "Get-Help Get-Datasource -detailed".
For technical information, type "Get-Help Get-Datasource -full".Additionally, any updated information about the cmdlet will be available at https://go.microsoft.com/fwlink/?LinkId=95130.
Examples
EXAMPLE 1
$ps = Get-ProductionServer -DPMServerName TestingServer
Get-Datasource -ProductionServer $ps[1] -Inquire
This command returns the list of all data sources on a computer.
EXAMPLE 2
$pg = Get-ProtectionGroup -DPMServerName TestingServer
Get-Datasource -ProtectionGroup $pg
This command retrieves the protected data sources in the specified protection group.
EXAMPLE 3
Get-Datasource -DPMServerName "TestingServer" -Inactive
This command retrieves the inactive data sources on a server.
EXAMPLE 4
Get-Datasource -DPMServerName TestingServer -SearchPath "F:\" -ProductionServer "test.contoso.com"
This command retrieves the data source from the specified search location.
Help Example