Skip to content

Latest commit

 

History

History
368 lines (290 loc) · 9.67 KB

Set-CMDatabaseReplicationLinkProperty.md

File metadata and controls

368 lines (290 loc) · 9.67 KB
Raw
description external help file Module Name ms.date schema title
Changes configuration settings for a database replication link.
AdminUI.PS.dll-Help.xml
ConfigurationManager
05/07/2019
2.0.0
Set-CMDatabaseReplicationLinkProperty

Set-CMDatabaseReplicationLinkProperty

SYNOPSIS

Changes configuration settings for a database replication link.

SYNTAX

SetBySiteCodeMandatory (Default)

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>]

SetScheduleBySiteCodeMandatory

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 20

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.

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 HINVSINV

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.

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
Parameter Sets: SetScheduleBySiteCodeMandatory
Aliases:
Accepted values: Closed, HINV, SINV, HINVSINV, StatMSG, HINVStatMSG, SINVStatMSG, HINVSINVStatMSG

Required: True
Position: Named
Default value: None
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
Parameter Sets: (All)
Aliases: Site2

Required: True
Position: Named
Default value: None
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[]
Parameter Sets: SetScheduleBySiteCodeMandatory
Aliases:
Accepted values: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday

Required: True
Position: Named
Default value: None
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
Parameter Sets: SetBySiteCodeMandatory
Aliases:

Required: False
Position: Named
Default value: None
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
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
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
Parameter Sets: SetBySiteCodeMandatory
Aliases:

Required: False
Position: Named
Default value: None
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
Parameter Sets: SetBySiteCodeMandatory
Aliases:

Required: False
Position: Named
Default value: None
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
Parameter Sets: SetBySiteCodeMandatory
Aliases:

Required: False
Position: Named
Default value: None
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
Parameter Sets: SetBySiteCodeMandatory
Aliases:

Required: False
Position: Named
Default value: None
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
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-GenerateReplicationDownAlert

Indicates whether to generate a replication down alert.

Type: Boolean
Parameter Sets: SetBySiteCodeMandatory
Aliases:

Required: False
Position: Named
Default value: None
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
Parameter Sets: (All)
Aliases: Site1

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ReplicationDataTrafficSummarizationMins

Type: Int32
Parameter Sets: SetBySiteCodeMandatory
Aliases: ReplicationDataTrafficSummarizationIntervalMinutes

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ReplicationDownAlertMins

Type: Int32
Parameter Sets: SetBySiteCodeMandatory
Aliases: ReplicationDownAlertThresholdMinutes

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ReplicationEndHr

Type: Int32
Parameter Sets: SetScheduleBySiteCodeMandatory
Aliases: TimePeriodEnd, ReplicationEndHour

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ReplicationStartHr

Type: Int32
Parameter Sets: SetScheduleBySiteCodeMandatory
Aliases: TimePeriodStart, ReplicationStartHour

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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 doesn't run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

None

OUTPUTS

System.Object

NOTES

RELATED LINKS

Get-CMDatabaseReplicationLinkProperty

Get-CMDataBaseReplicationStatus