Set-DfsrGroupSchedule

Module:

DFSR

Modifies a replication group schedule.

Syntax

Set-DfsrGroupSchedule
   [-GroupName] <String[]>
   [[-UseUTC] <Boolean>]
   [[-ScheduleType] <GroupScheduleType>]
   [[-DomainName] <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-DfsrGroupSchedule
   [-GroupName] <String[]>
   [[-UseUTC] <Boolean>]
   [-Day] <DayOfWeek[]>
   [-BandwidthDetail] <String>
   [[-DomainName] <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Set-DfsrGroupSchedule cmdlet modifies a schedule for a replication group. Distributed File System (DFS) Replication schedules control the availability and bandwidth usage of replication.

By default, DFS Replication schedules replication 24 hours per day, 7 days per week with full bandwidth as the recommended configuration.

Examples

Example 1: Modify a group schedule

PS C:\> Set-DfsrGroupSchedule -GroupName "RG01" -ScheduleType Always
GroupName            : RG01
DomainName           : corp.contoso.com
ReplicationGroupGuid : 1f06f8d4-a0ae-4221-99d2-0bd1bb27882b
UseUTC               : False
HoursReplicated      : 168
BandwidthDetail      : FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF

This command uses the Set-DfsrGroupSchedule cmdlet to modify the RG01 replication group to allow full replication 24 hours per day, 7 days per week. The command also uses the ScheduleType parameter so there is no need to specify any specific bandwidth blocks or days.

Example 2: Modify a group schedule to prevent replication

PS C:\> Set-DfsrGroupSchedule -GroupName "RG01" -Day Monday,Tuesday,Wednesday,Thursday,Friday -BandwidthDetail ffffffffffffffffffffffffffffffffffff00000000000000000000000000000000ffffffffffffffffffffffffffff
GroupName            : RG01
DomainName           : corp.contoso.com
ReplicationGroupGuid : 1f06f8d4-a0ae-4221-99d2-0bd1bb27882b
UseUTC               : False
HoursReplicated      : 128
BandwidthDetail      : FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF00000000000000000000000000000000FFFFFFFFFFFFFFFFFFFFFFFFFFFF
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF00000000000000000000000000000000FFFFFFFFFFFFFFFFFFFFFFFFFFFF
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF00000000000000000000000000000000FFFFFFFFFFFFFFFFFFFFFFFFFFFF
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF00000000000000000000000000000000FFFFFFFFFFFFFFFFFFFFFFFFFFFF
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF00000000000000000000000000000000FFFFFFFFFFFFFFFFFFFFFFFFFFFF
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF

This command uses the Set-DfsrGroupSchedule cmdlet to modify the RG01 replication group schedule to prevent all replication from 9AM to 5PM Monday through Friday, with all other intervals replicating at full bandwidth.

Parameters

-BandwidthDetail

Specifies a custom schedule value string that defines the bandwidth settings for each 15-minute interval block, with 4 blocks to a set, where each set represents 1 hour, and there are 24 sets. The time starts at 00:00 and ends at 24:00. The valid settings on a 15-minute block are 0 through F, with the following mapping of settings:

• 0 = No replication
• 1 = 16 kilobits per second (Kbps)
• 2 = 64 Kbps
• 3 = 128 Kbps
• 4 = 256 Kbps
• 5 = 512 Kbps
• 6 = 1 megabit per second (Mbps)
• 7 = 2 Mbps
• 8 = 4 Mbps
• 9 = 8 Mbps
• A = 16 Mbps
• B = 32 Mbps
• C = 64 Mbps
• D = 128 Mbps
• E = 256 Mbps
• F = Full bandwidth replication

You must specify a complete value string and include all 24 hourly 4-block sets (for a total of 96 hexadecimal characters). For example: ffffffffffff0000ffff0000ffff00004444000044440000444400004444000044440000ffff0000ffff0000ffffffff

Type:	String
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Day

Specifies a day of the week. You can specify either an enumerated string value or its corresponding integer value. The acceptable values for this parameter are:

• Sunday (0)
• Monday (1)
• Tuesday (2)
• Wednesday (3)
• Thursday (4)
• Friday (5)
• Saturday (6)

Type:	DayOfWeek[]
Accepted values:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DomainName

Specifies the NetBIOS name or fully qualified domain name (FQDN) for the Active Directory Domain Service (AD DS) domain that contains a replication group. If you do not specify this parameter, the cmdlet uses the current domain.

Type:	String
Position:	100
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-GroupName

Specifies an array of names of replication groups. If you do not specify this parameter, the cmdlet applies to all participating replication groups. You can use a comma separated list and the wildcard character (*).

Type:	String[]
Aliases:	RG, RgName
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	True

-ScheduleType

Specifies a schedule type with no replication allowed or a full schedule that enables replication for 24 hours a day, 7 days a week using full bandwidth. The acceptable values for this parameter are: Never (0) and Always (1). You can specify either an enumerated string value or its corresponding integer value for this parameter.

Type:	GroupScheduleType
Accepted values:	Never, Always
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseUTC

Indicates whether the destination computer uses Coordinated Universal Time (UTC) for its schedule. By default, the destination computer interprets the schedule according to its local time.

Type:	Boolean
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Inputs

Microsoft.DistributedFileSystemReplication.DfsReplicationGroup

Outputs

Microsoft.DistributedFileSystemReplicationDfsrgroupSchedule

Related Links

• Get-DfsrGroupSchedule