Update-MgDeviceManagementExchangeConnector

Module:

Microsoft.Graph.DeviceManagement.Administration

Update the properties of a deviceManagementExchangeConnector object.

Note

To view the beta release of this cmdlet, view Update-MgBetaDeviceManagementExchangeConnector

Syntax

Update-MgDeviceManagementExchangeConnector
      -DeviceManagementExchangeConnectorId <String>
      [-ResponseHeadersVariable <String>]
      [-AdditionalProperties <Hashtable>]
      [-ConnectorServerName <String>]
      [-ExchangeAlias <String>]
      [-ExchangeConnectorType <DeviceManagementExchangeConnectorType>]
      [-ExchangeOrganization <String>]
      [-Id <String>]
      [-LastSyncDateTime <DateTime>]
      [-PrimarySmtpAddress <String>]
      [-ServerName <String>]
      [-Status <DeviceManagementExchangeConnectorStatus>]
      [-Version <String>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-MgDeviceManagementExchangeConnector
      -DeviceManagementExchangeConnectorId <String>
      -BodyParameter <IMicrosoftGraphDeviceManagementExchangeConnector>
      [-ResponseHeadersVariable <String>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-MgDeviceManagementExchangeConnector
      -InputObject <IDeviceManagementAdministrationIdentity>
      [-ResponseHeadersVariable <String>]
      [-AdditionalProperties <Hashtable>]
      [-ConnectorServerName <String>]
      [-ExchangeAlias <String>]
      [-ExchangeConnectorType <DeviceManagementExchangeConnectorType>]
      [-ExchangeOrganization <String>]
      [-Id <String>]
      [-LastSyncDateTime <DateTime>]
      [-PrimarySmtpAddress <String>]
      [-ServerName <String>]
      [-Status <DeviceManagementExchangeConnectorStatus>]
      [-Version <String>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-MgDeviceManagementExchangeConnector
      -InputObject <IDeviceManagementAdministrationIdentity>
      -BodyParameter <IMicrosoftGraphDeviceManagementExchangeConnector>
      [-ResponseHeadersVariable <String>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Update the properties of a deviceManagementExchangeConnector object.

Examples

Example 1: Code snippet

Import-Module Microsoft.Graph.DeviceManagement.Administration

$params = @{
	"@odata.type" = "#microsoft.graph.deviceManagementExchangeConnector"
	lastSyncDateTime = [System.DateTime]::Parse("2017-01-01T00:02:49.3205976-08:00")
	status = "connectionPending"
	primarySmtpAddress = "Primary Smtp Address value"
	serverName = "Server Name value"
	connectorServerName = "Connector Server Name value"
	exchangeConnectorType = "hosted"
	version = "Version value"
	exchangeAlias = "Exchange Alias value"
	exchangeOrganization = "Exchange Organization value"
}

Update-MgDeviceManagementExchangeConnector -DeviceManagementExchangeConnectorId $deviceManagementExchangeConnectorId -BodyParameter $params

This example shows how to use the Update-MgDeviceManagementExchangeConnector Cmdlet.

Parameters

-AdditionalProperties

Additional Parameters

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

-BodyParameter

Entity which represents a connection to an Exchange environment. To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

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

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectorServerName

The name of the server hosting the Exchange Connector.

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

-DeviceManagementExchangeConnectorId

The unique identifier of deviceManagementExchangeConnector

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

-ExchangeAlias

An alias assigned to the Exchange server

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

-ExchangeConnectorType

The type of Exchange Connector.

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

-ExchangeOrganization

Exchange Organization to the Exchange server

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

-Headers

Optional headers that will be added to the request.

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

-Id

The unique identifier for an entity. Read-only.

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

-InputObject

Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.

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

-LastSyncDateTime

Last sync time for the Exchange Connector

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

-PrimarySmtpAddress

Email address used to configure the Service To Service Exchange Connector.

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

-ProgressAction

{{ Fill ProgressAction Description }}

Type:	ActionPreference
Aliases:	proga
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResponseHeadersVariable

Optional Response Headers Variable.

Type:	String
Aliases:	RHV
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerName

The name of the Exchange server.

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

-Status

The current status of the Exchange Connector.

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

-Version

The version of the ExchangeConnectorAgent

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Inputs

Microsoft.Graph.PowerShell.Models.IDeviceManagementAdministrationIdentity

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphDeviceManagementExchangeConnector

System.Collections.IDictionary

Outputs

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphDeviceManagementExchangeConnector

Notes

COMPLEX PARAMETER PROPERTIES

To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.

BODYPARAMETER <IMicrosoftGraphDeviceManagementExchangeConnector>: Entity which represents a connection to an Exchange environment.

• [(Any) <Object>]: This indicates any property can be added to this object.
• [Id <String>]: The unique identifier for an entity. Read-only.
• [ConnectorServerName <String>]: The name of the server hosting the Exchange Connector.
• [ExchangeAlias <String>]: An alias assigned to the Exchange server
• [ExchangeConnectorType <DeviceManagementExchangeConnectorType?>]: The type of Exchange Connector.
• [ExchangeOrganization <String>]: Exchange Organization to the Exchange server
• [LastSyncDateTime <DateTime?>]: Last sync time for the Exchange Connector
• [PrimarySmtpAddress <String>]: Email address used to configure the Service To Service Exchange Connector.
• [ServerName <String>]: The name of the Exchange server.
• [Status <DeviceManagementExchangeConnectorStatus?>]: The current status of the Exchange Connector.
• [Version <String>]: The version of the ExchangeConnectorAgent

INPUTOBJECT <IDeviceManagementAdministrationIdentity>: Identity Parameter

• [AuditEventId <String>]: The unique identifier of auditEvent
• [CloudPcAuditEventId <String>]: The unique identifier of cloudPcAuditEvent
• [CloudPcDeviceImageId <String>]: The unique identifier of cloudPcDeviceImage
• [CloudPcGalleryImageId <String>]: The unique identifier of cloudPcGalleryImage
• [CloudPcId <String>]: The unique identifier of cloudPC
• [CloudPcOnPremisesConnectionId <String>]: The unique identifier of cloudPcOnPremisesConnection
• [CloudPcProvisioningPolicyAssignmentId <String>]: The unique identifier of cloudPcProvisioningPolicyAssignment
• [CloudPcProvisioningPolicyId <String>]: The unique identifier of cloudPcProvisioningPolicy
• [CloudPcUserSettingAssignmentId <String>]: The unique identifier of cloudPcUserSettingAssignment
• [CloudPcUserSettingId <String>]: The unique identifier of cloudPcUserSetting
• [ComplianceManagementPartnerId <String>]: The unique identifier of complianceManagementPartner
• [DeviceAndAppManagementRoleAssignmentId <String>]: The unique identifier of deviceAndAppManagementRoleAssignment
• [DeviceManagementExchangeConnectorId <String>]: The unique identifier of deviceManagementExchangeConnector
• [DeviceManagementPartnerId <String>]: The unique identifier of deviceManagementPartner
• [IosUpdateDeviceStatusId <String>]: The unique identifier of iosUpdateDeviceStatus
• [MobileThreatDefenseConnectorId <String>]: The unique identifier of mobileThreatDefenseConnector
• [RemoteAssistancePartnerId <String>]: The unique identifier of remoteAssistancePartner
• [ResourceOperationId <String>]: The unique identifier of resourceOperation
• [RoleAssignmentId <String>]: The unique identifier of roleAssignment
• [RoleDefinitionId <String>]: The unique identifier of roleDefinition
• [TelecomExpenseManagementPartnerId <String>]: The unique identifier of telecomExpenseManagementPartner
• [TermsAndConditionsAcceptanceStatusId <String>]: The unique identifier of termsAndConditionsAcceptanceStatus
• [TermsAndConditionsAssignmentId <String>]: The unique identifier of termsAndConditionsAssignment
• [TermsAndConditionsId <String>]: The unique identifier of termsAndConditions
• [UserId <String>]: The unique identifier of user

Related Links

• https://learn.microsoft.com/powershell/module/microsoft.graph.devicemanagement.administration/update-mgdevicemanagementexchangeconnector
• https://learn.microsoft.com/graph/api/intune-onboarding-devicemanagementexchangeconnector-update?view=graph-rest-1.0