Creación o modificación de un emparejamiento de Exchange mediante PowerShell
En este artículo se describe cómo crear un emparejamiento de Microsoft Exchange con cmdlets de PowerShell y el modelo de implementación de Resource Manager. También se muestra cómo comprobar el estado del recurso, así como la forma de actualizarlo o eliminarlo y desaprovisionarlo.
Si lo prefiere, puede realizar los pasos de esta guía mediante Azure Portal.
Antes de empezar
- Revise los requisitos previos y el Tutorial del emparejamiento de Exchange antes de comenzar la configuración.
- Si ya dispone de emparejamientos de Exchange con Microsoft que no se convertirán en recursos de Azure, consulte el artículo Conversión de un emparejamiento de Exchange heredado en un recurso de Azure mediante PowerShell.
Funcionamiento con Azure PowerShell
Para ejecutar los cmdlets, puede usar Azure Cloud Shell, un shell interactivo gratuito. Tiene las herramientas comunes de Azure preinstaladas y configuradas para usarlas en la cuenta. Seleccione Copy (Copiar) para copiar el código y péguelo en Cloud Shell. Seleccione Entrar para ejecutarlo. Hay unas cuantas maneras de iniciar Cloud Shell:
| Método de inicio | Instantánea |
|---|---|
| Abra Cloud Shell en el explorador. |  |
| Haga clic en el botón Cloud Shell en la barra de herramientas en la parte superior derecha de Azure Portal. |  |
Si no desea usar Azure Cloud Shell, puede instalar PowerShell localmente en su lugar. Si elige instalar y usar PowerShell de forma local, asegúrese de instalar la versión más reciente de los cmdlets de PowerShell de Azure Resource Manager. Los cmdlets de PowerShell se actualizan con frecuencia. Normalmente necesita actualizar los cmdlets de PowerShell para obtener la funcionalidad más reciente de la característica. Si no lo hace, puede encontrarse con problemas.
Para encontrar la versión de PowerShell que se ejecuta localmente, use el cmdlet "Get-Module -ListAvailable Az". Para realizar la actualización, consulte Instalación del módulo de Azure PowerShell. Para más información, consulte Instalación y configuración de Azure PowerShell.
Si usa PowerShell en macOS, siga los pasos descritos en Instalación de PowerShell en macOS.
Creación y aprovisionamiento de un emparejamiento de Exchange
Iniciar sesión en la cuenta de Azure y seleccione la suscripción
Antes de comenzar la configuración, instale e importe los módulos necesarios. Necesitará privilegios de administrador para instalar los módulos en PowerShell.
Instale e importe el módulo Az
Install-Module Az -AllowClobber Import-Module AzInstale e importe el módulo Az.Peering.
Install-Module -Name Az.Peering -AllowClobber Import-Module Az.PeeringUse este comando para comprobar que los módulos se importaron correctamente:
Get-ModuleInicie sesión en su cuenta de Azure mediante este comando:
Connect-AzAccountCompruebe las suscripciones de la cuenta y seleccione la suscripción en la que desea crear un emparejamiento.
Get-AzSubscription Select-AzSubscription -SubscriptionId "subscription-id"Si todavía no tiene un grupo de recursos, debe crear uno antes de crear un emparejamiento. Para ello, ejecute el siguiente comando:
New-AzResourceGroup -Name "PeeringResourceGroup" -Location "Central US"
Importante
Si aún no ha asociado el ASN y la suscripción, siga los pasos que se indican en Asociación del ASN del mismo nivel. Esta acción es necesaria para solicitar un emparejamiento.
Nota:
La ubicación del grupo de recursos es independiente de la ubicación en la que decida configurar un emparejamiento.
Obtención de la lista de ubicaciones de emparejamiento compatibles para el emparejamiento de Exchange
El cmdlet Get-AzPeeringLocation de PowerShell devuelve una lista de ubicaciones de emparejamiento con el parámetro obligatorio Kind, que se usará en pasos posteriores:
Get-AzPeeringLocation -Kind "Exchange"
Las ubicaciones de emparejamiento de Exchange contienen los siguientes campos:
- ExchangeName
- PeeringLocation
- Country
- PeeringDBFacilityId
- PeeringDBFacilityLink
- MicrosoftIPv4Address
- MicrosoftIPv6Address
Para comprobar que está presente en la instalación de emparejamiento deseada consulte PeeringDB.
En este ejemplo se muestra cómo usar Seattle como ubicación de emparejamiento para crear un emparejamiento.
$exchangeLocations = Get-AzPeeringLocation -Kind Exchange
$exchangeLocation = $exchangeLocations | where {$_.PeeringLocation -eq "Seattle"}
#check the location metadata
$exchangeLocation
ExchangeName : Columbia IX
PeeringLocation : Seattle
Country : US
PeeringDBFacilityId : 99999
PeeringDBFacilityLink : https://www.peeringdb.com/ix/99999
MicrosoftIPv4Address : 10.12.97.129
MicrosoftIPv6Address :
ExchangeName : Equinix Seattle
PeeringLocation : Seattle
Country : US
PeeringDBFacilityId : 11
PeeringDBFacilityLink : https://www.peeringdb.com/ix/11
MicrosoftIPv4Address : 198.32.134.152
MicrosoftIPv6Address : 2001:504:12::15
...
Creación de un emparejamiento de Exchange
En el ejemplo siguiente se muestra cómo crear una conexión de Exchange en Equinix Internet Exchange en Seattle. Si usa otro proveedor y otra configuración, sustituya esa información al realizar la solicitud.
Use el cmdlet de PowerShell New-AzPeeringExchangeConnectionObject para crear objetos de conexión de PowerShell, que se usarán para generar la nueva solicitud de emparejamiento:
En este ejemplo se muestra cómo crear una conexión de Exchange.
$connection1 = New-AzPeeringExchangeConnectionObject `
-PeeringDBFacilityId $exchangeLocation[1].PeeringDBFacilityId `
-PeerSessionIPv4Address 198.32.134.22 `
-PeerSessionIPv6Address 2001:504:12::22 `
-MaxPrefixesAdvertisedIPv4 2000 `
-MaxPrefixesAdvertisedIPv6 2000 `
Cree otra conexión si necesita redundancia en la ubicación de emparejamiento dada.
$connection2 = New-AzPeeringExchangeConnectionObject `
-PeeringDBFacilityId $exchangeLocation[1].PeeringDBFacilityId `
-PeerSessionIPv4Address 198.32.134.23 `
-PeerSessionIPv6Address 2001:504:12::23 `
-MaxPrefixesAdvertisedIPv4 2000 `
-MaxPrefixesAdvertisedIPv6 2000 `
El cmdlet de PowerShell New-AzPeering se puede usar para crear un emparejamiento de Exchange.
$asn = Get-AzPeerAsn
New-AzPeering `
-Name "SeattleExchangePeering" `
-ResourceGroupName "PeeringResourceGroup" `
-PeerAsnResourceId $asn.Id `
-PeeringLocation $exchangeLocation[1].PeeringLocation `
-ExchangeConnection $connection1[, $connection2]
En esta respuesta de ejemplo se muestra cuándo se ejecutó la solicitud mediante una conexión.
Name : SeattleExchangePeering
Sku.Name : Basic_Exchange_Free
Kind : Exchange
Connections : {11}
PeerAsn.Id : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/{peerAsnName}
PeeringLocation : Seattle
ProvisioningState : Succeeded
Location : West US 2
Id : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleExchangePeering
Type : Microsoft.Peering/peerings
Tags : {}
Importante
Microsoft inicia el aprovisionamiento del emparejamiento solicitado y ConnectionState refleja el progreso.
Para más información sobre los pasos relacionados con el aprovisionamiento, consulte el tutorial de emparejamiento de Exchange.
Puede comprobar el estado de la conexión como se muestra a continuación:
$peering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"
$peering.Connections
PeeringDBFacilityId : 11
PeerSessionIPv4Address : 198.32.134.22
PeerSessionIPv6Address : 2001:504:12::22
SessionStateV4 : PendingAdd
SessionStateV6 : PendingAdd
MaxPrefixesAdvertisedV4 : 2000
MaxPrefixesAdvertisedV6 : 2000
MicrosoftSessionIPv4Address : 198.32.134.152
MicrosoftSessionIPv4Address : 2001:504:12::15
Md5AuthenticationKey :
Obtención de un emparejamiento de Exchange
Para obtener la lista de emparejamientos, ejecute el comando Get-AzPeering.
Get-AzPeering ResourceGroupName "PeeringResourceGroup" -Name "SeattleExchangePeering"
En esta respuesta de ejemplo se muestra el momento en que el aprovisionamiento de un extremo a otro se ha completado correctamente:
Name : SeattleExchangePeering
Sku : Basic_Exchange_Free
Kind : Exchange
PeeringLocation : Seattle
ProvisioningState : Succeeded
PeerAsn : 65000
Connection : ------------------------
PeerSessionIPv4Address : 10.21.31.100
MicrosoftIPv4Address : 10.21.31.50
SessionStateV4 : Established
MaxPrefixesAdvertisedV4 : 20000
PeerSessionIPv6Address : fe01::3e:100
MicrosoftIPv6Address : fe01::3e:50
SessionStateV6 : Established
MaxPrefixesAdvertisedV6 : 2000
ConnectionState : Active
Connection : ------------------------
PeerSessionIPv4Address : 10.21.31.101
MicrosoftIPv4Address : 10.21.31.51
SessionStateV4 : Established
MaxPrefixesAdvertisedV4 : 20000
PeerSessionIPv6Address : fe01::3e:101
MicrosoftIPv6Address : fe01::3e:51
SessionStateV6 : Established
MaxPrefixesAdvertisedV6 : 2000
ConnectionState : Active
Modificación de un emparejamiento de Exchange
Las siguientes operaciones de modificación son compatibles con el emparejamiento de Exchange:
- Adición de conexiones de emparejamiento de Exchange
- Eliminación de conexiones de emparejamiento de Exchange
- Adición de una sesión IPv4 o IPv6 en conexiones activas
- Eliminación de una sesión IPv4 o IPv6 en conexiones activas
Adición de conexiones de emparejamiento de Exchange
En el ejemplo siguiente se describe cómo agregar conexiones a un emparejamiento de Exchange existente.
$exchangePeering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"
$connection = New-AzPeeringExchangeConnectionObject `
-PeeringDBFacilityId $exchangeLocation[1].PeeringDBFacilityId `
-PeerSessionIPv4Address 198.32.134.22 `
-PeerSessionIPv6Address 2001:504:12::22 `
-MaxPrefixesAdvertisedIPv4 2000 `
-MaxPrefixesAdvertisedIPv6 2000 `
$exchangePeering.Connections.Add($connection)
$exchangePeering | Update-AzPeering
Eliminación de conexiones de emparejamiento de Exchange
En el ejemplo siguiente se describe cómo eliminar conexiones de un emparejamiento de Exchange existente.
$exchangePeering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"
Vea todas las conexiones y seleccione la que quiera quitar.
$exchangePeering
Name : SeattleExchangePeering
Sku.Name : Basic_Exchange_Free
Kind : Exchange
Connections : {11}
PeerAsn.Id : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/{peerAsnName}
PeeringLocation : Seattle
ProvisioningState : Succeeded
Location : West US 2
Id : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleExchangePeering
Type : Microsoft.Peering/peerings
Tags : {}
En el siguiente comando, en lugar de 0, escriba el número de índice de la conexión que quiere quitar.
$connection = $exchangePeering.Connections[0]
$exchangePeering.Connections.Remove($connection)
$exchangePeering | Update-AzPeering
Adición de una sesión IPv4 o IPv6 en conexiones activas
En el ejemplo siguiente se describe cómo agregar una sesión IPv6 a una conexión de Exchange existente.
$exchangePeering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"
$exchangePeering.Connections[0].BgpSession.PeerSessionIPv6Address = "2001:504:12::34"
$exchangePeering | Update-AzPeering
Eliminación de una sesión IPv4 o IPv6 en conexiones activas
Eliminar una sesión IPv4 o IPv6 de una conexión existente no se admite actualmente en PowerShell. Para más información, póngase en contacto con el servicio de emparejamiento de Microsoft.
Desaprovisionamiento de un emparejamiento de Exchange
Actualmente, el desaprovisionamiento no se admite mediante Azure Portal ni PowerShell. Para hacerlo, póngase en contacto con el servicio de emparejamiento de Microsoft.
Recursos adicionales
Puede obtener una descripción detallada de todos los parámetros ejecutando el siguiente comando:
Get-Help Get-AzPeering -detailed