Skip to main content

Register-DMExchange

SYNOPSIS​

Registers an exchange version to apply to the domain's exchange objects.

SYNTAX​

Version​

Register-DMExchange -LocalImagePath <string> -ExchangeVersion <string> [-ContextName <string>]
 [<CommonParameters>]

Details​

Register-DMExchange -LocalImagePath <string> [-ObjectVersion <int>] [-ContextName <string>]
 [<CommonParameters>]

DESCRIPTION​

Registers an exchange version to apply to the domain's exchange objects. Updating this requires Enterprise Admin permissions.

EXAMPLES​

EXAMPLE 1​

Register-DMExchange -LocalImagePath 'C:\ISO\exchange-2019-cu6.iso' -ExchangeVersion '2019CU6'

Registers the Exchange 2019 CU6 exchange version as exchange domain settings to be applied.

PARAMETERS​

-ContextName​

The name of the context defining the setting. This allows determining the configuration set that provided this setting. Used by the ADMF, available to any other configuration management solution.

Type: System.String
DefaultValue: <Undefined>
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ExchangeVersion​

The version of the Exchange server to apply. E.g. 2016CU6 We map Exchange versions to their respective identifier in AD: ObjectVersion in the domain's Microsoft Exchange System Objects container. This parameter is to help avoiding to have to look up that value. If your version is not supported by us yet, look up the version number and explicitly bind it to -ObjectVersion instead.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Version
  Position: Named
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-LocalImagePath​

The path where to find the Exchange ISO file Must be local on the remote server connected to! Updating the Exchange AD settings is only supported when executed through the installer contained in that ISO file without exceptions.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ObjectVersion​

The object version on the "Microsoft Exchange System Objects" container in the domain.

Type: System.Int32
DefaultValue: 0
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Details
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters​

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