New-EdgeSubscription
Este cmdlet solo está disponible en el entorno local de Exchange.
Utilice el cmdlet New-EdgeSubscription para exportar un archivo de suscripción perimetral de un servidor de transporte perimetral e importarlo en un servidor de buzones de correo.
Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.
Sintaxis
Default (valor predeterminado)
New-EdgeSubscription
[-AccountExpiryDuration <TimeSpan>]
[-Confirm]
[-CreateInboundSendConnector <Boolean>]
[-CreateInternetSendConnector <Boolean>]
[-DomainController <Fqdn>]
[-FileData <Byte[]>]
[-FileName <LongPath>]
[-Force]
[-Site <AdSiteIdParameter>]
[-WhatIf]
[<CommonParameters>]
Description
El servidor de transporte perimetral no tiene acceso a Active Directory. Toda la información de configuración y destinatarios se almacena en la instancia de Active Directory Lightweight Directory Services (AD LDS). El cmdlet New-EdgeSubscription crea el archivo de suscripción de Edge para importarlo a un servidor de buzones de correo en el sitio de Active Directory en el que desea suscribirse a este servidor de transporte de Edge.
Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que tiene asignados. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.
Ejemplos
Ejemplo 1
New-EdgeSubscription -FileName "C:\Data\EdgeSubscription.xml"
En este ejemplo se crea el archivo de suscripción perimetral. Debe ejecutarse en el servidor Transporte perimetral.
Ejemplo 2
$Temp = [System.IO.File]::ReadAllBytes('C:\Data\EdgeSubscription.xml')
New-EdgeSubscription -FileData $Temp -Site "Default-First-Site-Name"
En este ejemplo se importa el archivo de suscripción de Edge generado en el ejemplo 1 al nombre predeterminado-primer-sitio-nombre del sitio de Active Directory. La importación del archivo de suscripción perimetral completa el proceso de suscripción perimetral. Debe ejecutar este comando en el servidor de buzones de correo.
El primer comando lee los datos del archivo de suscripción perimetral y los almacena en una variable temporal como objeto de datos de bytes cifrados. El segundo comando completa el proceso de suscripción perimetral.
Ejemplo 3
New-EdgeSubscription -FileData ([System.IO.File]::ReadAllBytes('C:\Data\EdgeSubscription.xml')) -Site "Default-First-Site-Name"
En este ejemplo también se importa el archivo de suscripción de Edge generado en el ejemplo 1 al Default-First-Site-Name del sitio de Active Directory; Sin embargo, el resultado final se logra con un solo comando. Debe ejecutar este comando en el servidor de buzones de correo.
Parámetros
-AccountExpiryDuration
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro AccountExpiryDuration especifica cuándo expira la cuenta de replicación de arranque de EdgeSync (ESBRA) creada por este comando.
Para especificar un valor, escríbalo como un intervalo de tiempo: dd.hh:mm:ss donde dd = días, hh = horas, mm = minutos y ss = segundos.
El valor para este parámetro debe ser como mínimo de 00:02:00 o 2 minutos. El valor predeterminado es 24:00:00 o 24 horas.
Propiedades de parámetro
| Tipo: | TimeSpan |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador al cmdlet depende de si el cmdlet requiere confirmación antes de continuar.
- Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta:
-Confirm:$false. - La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. Para estos cmdlets, especificar el modificador Confirm sin un valor introduce una pausa que le obliga a reconocer el comando antes de continuar.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-CreateInboundSendConnector
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro CreateInboundSendConnector especifica si se debe crear el conector de envío para conectar el servidor Transporte perimetral y los servidores Transporte de concentradores. El valor predeterminado es $true. El espacio de direcciones del conector de envío se establece en "--", los hosts inteligentes se establecen en "--", el servidor de transporte perimetral se establece como servidor de origen y el enrutamiento del Sistema de nombres de dominio (DNS) se deshabilita. Este parámetro sólo se usa cuando se ejecuta el comando en el servidor de transporte de concentradores.
Propiedades de parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-CreateInternetSendConnector
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro CreateInternetSendConnector especifica si se debe crear el conector de envío para conectarse a Internet. El valor predeterminado es $true. El espacio de direcciones del conector de envío se configura para que incluya todos los dominios (*), el servidor Transporte perimetral se establece como servidor de origen y se habilita el enrutamiento de DNS. Este parámetro sólo se usa cuando se ejecuta el comando en el servidor de transporte de concentradores.
Propiedades de parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-DomainController
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.
El parámetro DomainController no es compatible con los servidores de transporte perimetral. Un servidor de transporte perimetral usa la instancia local de Active Directory Lightweight Directory Services (AD LDS) para leer y escribir datos.
Propiedades de parámetro
| Tipo: | Fqdn |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-FileData
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro FileData especifica el objeto de datos de bytes cifrados que contiene la información del archivo de suscripción perimetral.
Un valor válido para este parámetro requiere que lea el archivo en un objeto codificado en bytes utilizando la sintaxis siguiente: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Puede usar este comando como valor de parámetro, o puede escribir la salida en una variable ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) y usar la variable como el valor de parámetro ($data).
Solo puede usar este parámetro cuando esté ejecutando el comando en un servidor de buzones de correo.
Propiedades de parámetro
| Tipo: | Byte[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-FileName
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro FileName especifica la ruta de acceso completa del archivo de suscripción perimetral.
Puede usar este parámetro sólo cuando se está ejecutando este comando en un servidor Transporte perimetral.
Propiedades de parámetro
| Tipo: | LongPath |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Force
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El modificador Force oculta los mensajes de advertencia o confirmación. No es necesario especificar un valor con este modificador.
Este modificador es útil en los siguientes escenarios:
- Omitir la confirmación al escribir el comando de suscripción de Microsoft Edge.
- Recrear una suscripción de servidor de transporte perimetral y sobrescribir la información de configuración existente.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Site
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro Site especifica el nombre del sitio de Active Directory que contiene los servidores de buzones de correo a los que están asociados los servidores de transporte perimetrales. Este parámetro sólo se utiliza y es necesario cuando el comando se ejecuta en un servidor de buzones de correo.
Propiedades de parámetro
| Tipo: | AdSiteIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El modificador WhatIf muestra lo que hace el comando sin realizar ningún cambio. No es necesario especificar un valor con este modificador.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.
Entradas
Input types
Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.
Salidas
Output types
Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.