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