Set-​Msol​Dir​Sync​Feature

Sets identity synchronization features for a tenant.

Syntax

Set-MsolDirSyncFeature
   -Feature <String>
   -Enable <Boolean>
   [-TenantId <Guid>]
   [-Force]
   [<CommonParameters>]

Description

The Set-MsolDirSyncFeature cmdlet sets identity synchronization features for a tenant.

Synchronization features that can be used with this cmdlet include the following:

  • EnableSoftMatchOnUpn. Soft Match is the process used to link an object being synced from on-premises for the first time with one that already exists in the cloud. When this feature is enabled Soft Match will first be attempted using the standard logic, based on primary SMTP address. If a match is not found based on primary SMTP, then a match will be attempted based on UserPrincipalName. Once this feature is enabled it cannot be disabled.
  • PasswordSync
  • SynchronizeUpnForManagedUsers. allows for the synchronization of UserPrincipalName updates from on-premises for managed (non-federated) users that have been assigned a license. These updates will be blocked if this feature is not enabled. Once this feature is enabled it cannot be disabled.

Enabling some of these features, such as EnableSoftMatchOnUpn and SynchronizationUpnForManagedUsers is a permanent operation. These features cannot be disabled once they are enabled.

Examples

Example 1: Enable a feature for the tenant

PS C:\> Set-MsolDirSyncFeature -Feature EnableSoftMatchOnUpn -Enable $True

This command enables the SoftMatchOnUpn feature for the tenant.

Required Parameters

-Enable

Indicates whether the specified feature will be turned on for the company.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Feature

Specifies the directory synchronization features to turn on or off.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

Optional Parameters

-Force

Forces the command to run without asking for user confirmation.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TenantId

Specifies the unique ID of the tenant to perform the operation on. If you do not specify this parameter the cmdlet will use the ID of the current user. This parameter is only applicable to partner users.

Type:Guid
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False