Set-CMMigrationSource

  • 3 minutes to read

SYNOPSIS

Specifies or changes settings for a migration source site in Configuration Manager.

SYNTAX

Set-CMMigrationSource -SourceSiteServerName <String> [-SmsProviderAccount <String>]
 [-SqlServerAccount <String>] [-EnableDistributionPointSharing <Boolean>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

The Set-CMMigrationSource cmdlet specifies or changes settings for a migration source site in Microsoft System Center Configuration Manager. To enable migration of data to your System Center Configuration Manager environment, you must configure a supported System Center Configuration Manager source hierarchy and specify one or more source sites that contain data that you want to migrate.

By default, the top-level site of the hierarchy becomes a source site of the source hierarchy. If you migrate from a Microsoft System Center Configuration Manager 2007 hierarchy, you can configure additional source sites for migration. If you migrate from a System Center Configuration Manager hierarchy, you do not need to configure additional source sites because the System Center Configuration Manager shared database at the top of the source hierarchy contains all of the information that you can migrate.

EXAMPLES

Example 1: Specify a migration source

PS C:\> Set-CMMigrationSource -SourceSiteServerName "cmdev-contoso01" -SmsProviderAccount "tsqa\pattifuller" -SqlServerAccount "tsqa\pattifuller" -EnableDistributionPointSharing $True

This command specifies the site server named cmdev-contoso01 as the source of migration data. It uses the user account for tsqa\pattifuller to provide access to the SQL Server database at the top of the source hierarchy and to connect to the SMS provider and source site database for the source site. The command also shares distribution points between the source and destination hierarchies.

PARAMETERS

-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

-DisableWildcardHandling

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: 

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

-EnableDistributionPointSharing

Indicates whether Configuration Manager shares distribution points between source and destination hierarchies.

Type: Boolean
Parameter Sets: (All)
Aliases: 

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

-ForceWildcardHandling

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: 

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

-SmsProviderAccount

Specifies the name of the account that the top-level site in the destination hierarchy uses to connect to the SMS Provider and the site database of the source site. The top-level site uses these connections to retrieve objects and distribution points.

Type: String
Parameter Sets: (All)
Aliases: 

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

-SourceSiteServerName

Specifies the name of a server that contains a source site.

Type: String
Parameter Sets: (All)
Aliases: 

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

-SqlServerAccount

Specifies a SQL Server account that provides access to the top-level SQL Server database in the source hierarchy. The account must have read and run permissions for this database.

Type: String
Parameter Sets: (All)
Aliases: 

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not 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 (http://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

OUTPUTS

NOTES

Set-CMMigrationExclusionList

Clear-CMMigrationData