Set-CMDatabaseReplicationLinkProperty
Changes configuration settings for a database replication link.
Syntax
Set-CMDatabaseReplicationLinkProperty
-ChildSiteCode <String>
[-DegradedLinkStatusRetryCount <Int32>]
[-EnableDistributedViewForHardwareInventory <Boolean>]
[-EnableDistributedViewForSoftwareInventory <Boolean>]
[-EnableDistributedViewForStatusMessage <Boolean>]
[-FailedLinkStatusRetryCount <Int32>]
[-GenerateReplicationDownAlert <Boolean>]
-ParentSiteCode <String>
[-ReplicationDataTrafficSummarizationMins <Int32>]
[-ReplicationDownAlertMins <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMDatabaseReplicationLinkProperty
-AvailabilityLevel <InvAvailabilityLevel>
-ChildSiteCode <String>
-DaysOfWeek <DaysOfWeek[]>
-ParentSiteCode <String>
-ReplicationEndHr <Int32>
-ReplicationStartHr <Int32>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
The Set-CMDatabaseReplicationLinkProperty cmdlet changes configuration settings for a database replication link between a Configuration Manager parent site and child site.
Database replication for Configuration Manager sites transfers data and merges changes made in a site database with information stored at other sites in the Configuration Manager hierarchy. This enables all sites to share the same information.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.
Examples
Example 1: Change settings of a database replication link
PS XYZ:\> Set-CMDatabaseReplicationLinkProperty -ParentSiteCode "CCC" -ChildSiteCode "CCB" -EnableDistributedViewForHardwareInventory 1 -EnableDistributedViewForSoftwareInventory 1 -EnableDistributedViewForStatusMessage 1 -ReplicationDataTrafficSummarizationIntervalMinutes 12 -DegradedLinkStatusRetryCount 40 -FailedLinkStatusRetryCount 60 -GenerateReplicationDownAlert 1 -ReplicationDownAlertThresholdMinutes 20This command changes configuration settings for a database replication link between the Configuration Manager parent site that has the site code CCC and the child site that has the site code CCB.
Example 2: Set the schedule for a database replication link
PS XYZ:\> Set-CMDatabaseReplicationLinkProperty -ParentSiteCode "CCC" -ChildSiteCode "CCB" -DaysOfWeek Friday, Monday, Tuesday -TimePeriodStart 8 -TimePeriodEnd 0 -AvailabilityLevel HINVSINVThis command sets the schedule for the database replication link between the Configuration Manager parent site that has the site code CCC and the child site that has the site code CCB. The command specifies that Configuration Manager replicates the database for Configuration Manager sites on Friday, Monday, and Tuesday. The command specifies software and hardware inventory availability on the client computer.
Parameters
-AvailabilityLevel
Specifies the availability level for software and hardware inventory on a client computer. The acceptable values for this parameter are:
- Closed
- HINV
- SINV
- HINVSINV
- StatMSG
- HINVStatMSG
- SINVStatMSG
- HINVSINVStatMSG
| Type: | InvAvailabilityLevel |
| Accepted values: | Closed, HINV, SINV, HINVSINV, StatMSG, HINVStatMSG, SINVStatMSG, HINVSINVStatMSG |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ChildSiteCode
Specifies a site code for a Configuration Manager site. This parameter refers to the child site.
| Type: | String |
| Aliases: | Site2 |
| Position: | Named |
| 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 |
-DaysOfWeek
Specifies an array of day names that determine the days of each week on which Configuration Manager replicates the database for Configuration Manager sites. The acceptable values for this parameter are:
- Monday
- Tuesday
- Wednesday
- Thursday
- Friday
- Saturday
- Sunday
| Type: | DaysOfWeek[] |
| Accepted values: | Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DegradedLinkStatusRetryCount
Specifies a retry count when a replication group or object is delayed due to degraded link status.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableDistributedViewForHardwareInventory
Indicates whether Configuration Manager configures the SQL Server distributed partitioned views for hardware inventory.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableDistributedViewForSoftwareInventory
Indicates whether Configuration Manager configures the SQL Server distributed partitioned views for software inventory.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableDistributedViewForStatusMessage
Indicates whether Configuration Manager configures the SQL Server distributed partitioned views for status messages.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FailedLinkStatusRetryCount
Specifies a retry count when a replication group or object is delayed by failed link status.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-GenerateReplicationDownAlert
Indicates whether to generate a replication down alert.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ParentSiteCode
Specifies a site code for a Configuration Manager site. This parameter refers to the parent site.
| Type: | String |
| Aliases: | Site1 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReplicationDataTrafficSummarizationMins
| Type: | Int32 |
| Aliases: | ReplicationDataTrafficSummarizationIntervalMinutes |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReplicationDownAlertMins
| Type: | Int32 |
| Aliases: | ReplicationDownAlertThresholdMinutes |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReplicationEndHr
| Type: | Int32 |
| Aliases: | TimePeriodEnd, ReplicationEndHour |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReplicationStartHr
| Type: | Int32 |
| Aliases: | TimePeriodStart, ReplicationStartHour |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet doesn't run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
None
Outputs
System.Object
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