Set-DfsrGroupSchedule
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. DFS Replication schedules control the availability and bandwidth usage of replication.
By default, DFS Replication schedules replication 24 hours a day, 7 days a 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
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFThis command uses the Set-DfsrGroupSchedule cmdlet to modify the RG01 replication group to allow full replication 24 hours a day, 7 days a 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
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFThis 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. 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 a NetBIOS or fully qualified domain name (FQDN) for an Active Directory domain that contains the replication group. If you do not specify this parameter, the cmdlet uses the current domain.
| Type: | String |
| Position: | 100 |
| Default value: | [Current Domain] |
| 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 queries for all participating replication groups. You can specify multiple groups, separated by commas, as well as wildcard characters (*).
| Type: | String[] |
| Aliases: | RG, RgName |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-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. Acceptable values 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
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for