Set-CMDatabaseReplicationLinkProperty
Set-CMDatabaseReplicationLinkProperty
Changes configuration settings for a database replication link.
Syntax
Parameter Set: SetBySiteCodeMandatory
Set-CMDatabaseReplicationLinkProperty -ChildSiteCode <String> -ParentSiteCode <String> [-DegradedLinkStatusRetryCount <Int32> ] [-EnableDistributedViewForHardwareInventory <Boolean> ] [-EnableDistributedViewForSoftwareInventory <Boolean> ] [-EnableDistributedViewForStatusMessage <Boolean> ] [-FailedLinkStatusRetryCount <Int32> ] [-GenerateReplicationDownAlert <Boolean> ] [-ReplicationDataTrafficSummarizationIntervalMinutes <Int32> ] [-ReplicationDownAlertThresholdMinutes <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetScheduleBySiteCodeMandatory
Set-CMDatabaseReplicationLinkProperty -AvailabilityLevel <InvAvailabilityLevel> {Closed | HINV | SINV | HINVSINV | StatMSG | HINVStatMSG | SINVStatMSG | HINVSINVStatMSG} -ChildSiteCode <String> -DaysOfWeek {Friday | Monday | Saturday | Sunday | Thursday | Tuesday | Wednesday}[] -ParentSiteCode <String> -TimePeriodEnd <Int32> -TimePeriodStart <Int32> [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Set-CMDatabaseReplicationLinkProperty cmdlet changes configuration settings for a database replication link between a Microsoft System Center 2012 SP1 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.
Parameters
-AvailabilityLevel<InvAvailabilityLevel>
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
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ChildSiteCode<String>
Specifies a site code for a Configuration Manager site. This parameter refers to the child site.
Aliases |
Site2 |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DaysOfWeek<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
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DegradedLinkStatusRetryCount<Int32>
Specifies a retry count when a replication group or object is delayed due to degraded link status.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-EnableDistributedViewForHardwareInventory<Boolean>
Indicates whether Configuration Manager configures the SQL Server distributed partitioned views for hardware inventory.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-EnableDistributedViewForSoftwareInventory<Boolean>
Indicates whether Configuration Manager configures the SQL Server distributed partitioned views for software inventory.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-EnableDistributedViewForStatusMessage<Boolean>
Indicates whether Configuration Manager configures the SQL Server distributed partitioned views for status messages.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-FailedLinkStatusRetryCount<Int32>
Specifies a retry count when a replication group or object is delayed by failed link status.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-GenerateReplicationDownAlert<Boolean>
Indicates whether to generate a replication down alert.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ParentSiteCode<String>
Specifies a site code for a Configuration Manager site. This parameter refers to the parent site.
Aliases |
Site1 |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ReplicationDataTrafficSummarizationIntervalMinutes<Int32>
Specifies the interval, in minutes, at which Configuration Manager summarizes report data for database replication traffic for the link.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ReplicationDownAlertThresholdMinutes<Int32>
Specifies a threshold, in minutes, to elapse before Configuration Manager issues a replication down alert. Use this threshold to avoid sending alerts in response to false warnings.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-TimePeriodEnd<Int32>
Specifies an end time, in hours, of the period of time to wait before replication failures trigger the site to reinitializes its copy of the site database.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-TimePeriodStart<Int32>
Specifies a start time, in hours, of the period of time to wait before replication failures trigger the site to reinitializes its copy of the site database.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1: Change settings of a database replication link
This 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.
PS C:\> Set-CMDatabaseReplicationLinkProperty -ParentSiteCode "CCC" -ChildSiteCode "CCB" -EnableDistributedViewForHardwareInventory 1 -EnableDistributedViewForSoftwareInventory 1 -EnableDistributedViewForStatusMessage 1 -ReplicationDataTrafficSummarizationIntervalMinutes 12 -DegradedLinkStatusRetryCount 40 -FailedLinkStatusRetryCount 60 -GenerateReplicationDownAlert 1 -ReplicationDownAlertThresholdMinutes 20
Example 2: Set the schedule for a database replication link
This 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.
PS C:\> Set-CMDatabaseReplicationLinkProperty -ParentSiteCode "CCC" -ChildSiteCode "CCB" -DaysOfWeek Friday, Monday, Tuesday -TimePeriodStart 8 -TimePeriodEnd 0 -AvailabilityLevel HINVSINV