Cmdlets > Add-DtPhysicalRule

Add-DtPhysicalRule

Adds a physical rule to a workload

Syntax

Add-DtPhysicalRule [-ServiceHost] <Server> [-WorkloadId] <Guid> [-Exclude] [-NonRecursive] -Path <String> [<CommonParameters>]

Add-DtPhysicalRule [-ServiceHost] <Server> [-WorkloadId] <Guid> [-Rule] <PhysicalRule> [<CommonParameters>]

Detailed Description

This cmdlet adds a physical rule to the specified workload on the specified server.

Parameters

Name	Type	Description	Required	Pipeline Input
Service Host	Server	Specify the server object returned from the New-DtServer cmdlet. For this cmdlet, the -ServiceHost should be your source server.	true	false
WorkloadId	Guid	Specify the workload GUID returned from the New-DtWorkload cmdlet using the workload type name parameter.	true	false
Exclude	Switch Parameter	Exclude the specified path from mirroring and replication. If you do not specify this option, the path will be included for mirroring and replication.	false	false
NonRecursive	Switch Parameter	Apply the rule to the subdirectories of the specified path. If you do not specify this option, the subdirectories of the specified path will not be included/excluded.	false	false
Path	String	Specify the path on the source that contains the data that you want to protect	true	false
Rule	PhysicalRule	Use the Windows PowerShell New-Object cmdlet to create a physical rule object from DoubleTake.Common.Contract.PhysicalRule.	true	false

Outputs

ChangedItems

Examples

$DtServerObjectAlpha= New-DtServer -Name alpha -UserName domain\administrator -Password password

$DtWorkloadGuid = New-DtWorkload -ServiceHost $DtServerObjectAlpha -WorkloadTypeName FilesAndFolders

$DtPhysicalPath = New-Object DoubleTake.Common.Contract.PhysicalRule -Property @{Path="C:\DirName"}

Add-DtPhysicalRule -ServiceHost $DtServerObjectAlpha -WorkloadId $DtWorkloadGuid -Rule $DtPhysicalPath

Disconnect-DtServer -ServiceHost $DtServerObjectAlpha

A server object is created for the server alpha using the domain\administrator and password credentials. It assigns the server object to the variable called DtServerObjectAlpha. The script then creates a workload on the server for a files and folders job, returning a global unique ID for the workload, and assigns that ID to the variable DtWorkloadGuid. A new object is created from Double-Take.Common.Contract.PhysicalRule to store the physical path C:\DirName in the variable DtPhysicalPath. Finally, the physical rule is added to the workload on the server. The connections for the server object are then closed.

$DtServerObjectAlpha= New-DtServer -Name alpha -UserName domain\administrator -Password password

$DtWorkloadGuid = New-DtWorkload -ServiceHost $DtServerObjectAlpha -WorkloadTypeName FilesAndFolders

Add-DtPhysicalRule -ServiceHost $DtServerObjectAlpha -WorkloadId $DtWorkloadGuid -Path "C:\DirName"

Disconnect-DtServer -ServiceHost $DtServerObjectAlpha

A server object is created for the server alpha using the domain\administrator and password credentials. It assigns the server object to the variable called DtServerObjectAlpha. The script then creates a workload on the server for a files and folders job, returning a global unique ID for the workload, and assigns that ID to the variable DtWorkloadGuid. A physical rule is then created for the path C:\DirName. The connections for the server object are then closed.