New-EdgeSubscription

 

S’applique à :Exchange Server 2016

Dernière rubrique modifiée :2016-03-31

Cette cmdlet est disponible uniquement dans Exchange Server 2016 sur site.

Utilisez la cmdlet New-EdgeSubscription pour exporter un fichier d'abonnement Edge depuis un serveur de transport Edge vers un serveur de boîtes aux lettres Edge.

New-EdgeSubscription [-AccountExpiryDuration <TimeSpan>] [-Confirm [<SwitchParameter>]] [-CreateInboundSendConnector <$true | $false>] [-CreateInternetSendConnector <$true | $false>] [-DomainController <Fqdn>] [-FileData <Byte[]>] [-FileName <LongPath>] [-Force <SwitchParameter>] [-Site <AdSiteIdParameter>] [-WhatIf [<SwitchParameter>]]

Cet exemple crée le fichier d'abonnement Edge. Il doit être exécuté sur votre serveur de transport Edge.

New-EdgeSubscription -FileName "c:\EdgeServerSubscription.xml"

Cet exemple importe le fichier d’abonnement Edge généré dans l’exemple 1 sur le site Default-First-Site-Name d’Active Directory. L'importation du fichier d'abonnement Edge termine le processus d'abonnement Edge. Vous devez exécuter cette commande sur le serveur de boîtes aux lettres.

La première commande lit les données dans le fichier d'abonnement Edge et les stocke dans une variable temporaire sous forme d'objet de données codées en octets. La deuxième commande termine le processus d'abonnement Edge.

[byte[]]$Temp = Get-Content -Path "C:\EdgeServerSubscription.xml" -Encoding Byte -ReadCount 0
New-EdgeSubscription -FileData $Temp -Site "Default-First-Site-Name"

Cet exemple importe également le fichier d’abonnement Edge généré dans l’exemple 1 pour le site Default-First-Site-Name d’Active Directory. Toutefois, le résultat final est obtenu dans une seule ligne de code. Vous devez exécuter cette commande sur le serveur de boîtes aux lettres.

New-EdgeSubscription -FileData ([byte[]]$(Get-Content -Path "C:\EdgeServerSubscription.xml" -Encoding Byte -ReadCount 0)) -Site "Default-First-Site-Name"

Un serveur de transport Edge ne permet pas d'accéder à Active Directory. Toutes les informations relatives à la configuration et aux destinataires sont stockées dans l'instance AD LDS (Active Directory Lightweight Directory Services). La cmdlet New-EdgeSubscription crée le fichier d'abonnement Edge qui sera importé sur un serveur de boîtes aux lettres sur le site Active Directory sur lequel vous souhaitez créer un abonnement de transport Edge.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour voir les autorisations qui vous sont nécessaires, voir l'entrée « EdgeSync » dans la rubrique Autorisations de flux de messagerie.

 

Paramètre Obligatoire Type Description

AccountExpiryDuration

Facultatif

System.TimeSpan

Le paramètre AccountExpiryDuration spécifie le délai d'expiration du compte de démarrage créé par cette commande.

Pour spécifier une valeur, entrez-la sous forme d’une période : dd.hh:mm:ssdd = jours, hh = heures, mm = minutes et ss = secondes.

La valeur de ce paramètre doit être d'au moins 00:02:00 ou 2 minutes.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Confirm spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.

CreateInboundSendConnector

Facultatif

System.Boolean

Le paramètre CreateInboundSendConnector spécifie s'il faut créer le connecteur d'envoi pour connecter le serveur de transport Edge et les serveurs de transport Hub. La valeur par défaut est $true. L'espace d'adressage du connecteur d'envoi est défini sur « -- », les hôtes actifs définis sur « -- », le serveur de transport Edge défini comme serveur source et le routage DNS (Domain Name System) est désactivé. Ce paramètre n'est utilisé que si vous exécutez la commande sur le serveur de transport Hub.

CreateInternetSendConnector

Facultatif

System.Boolean

Le paramètre CreateInternetSendConnector spécifie s'il faut créer le connecteur d'envoi pour la connexion à Internet. La valeur par défaut est $true. L'espace d'adressage du connecteur d'envoi est défini sur tous les domaines (*), le serveur de transport Edge est défini comme serveur source et le routage DNS est désactivé. Ce paramètre n'est utilisé que si vous exécutez la commande sur le serveur de transport Hub.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : dc01.contoso.com.

Le paramètre DomainController n’est pas pris en charge sur les serveurs de transport Edge. Un serveur de transport Edge utilise l’instance locale de Active Directory Lightweight Directory Services (AD LDS) pour lire et écrire des données.

FileData

Facultatif

System.Byte[]

Le paramètre FileData spécifie l'objet de données codées en octets qui contient les informations du fichier d'abonnement Edge.

Pour plus d'informations sur la syntaxe requise pour utiliser ce paramètre, consultez la rubrique Référence rapide concernant l’environnement de ligne de commande Exchange Management Shell pour Exchange 2013.

Vous ne pouvez utiliser ce paramètre que si vous exécutez cette commande sur un serveur de boîtes aux lettres.

FileName

Facultatif

Microsoft.Exchange.Data.LongPath

Le paramètre FileName spécifie le chemin d'accès complet du fichier d'abonnement Edge.

Vous ne pouvez utiliser ce paramètre que si vous exécutez cette commande sur un serveur de transport Edge.

Force

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Force spécifie s’il faut supprimer les messages d’avertissement ou de confirmation. Vous pouvez utiliser ce commutateur pour exécuter des tâches par programme, lorsqu’une intervention administrative est inappropriée. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Ce commutateur est utile lorsque vous utilisez un script avec la commande d'abonnement Edge, car elle ignore la confirmation. Ce paramètre est également utile lorsque vous devez vous réabonner à un serveur de transport Edge et souhaitez remplacer les informations de configuration existantes.

Site

Facultatif

Microsoft.Exchange.Configuration.Tasks.AdSiteIdParameter

Le paramètre Site permet de spécifier le nom du site Active Directory qui héberge les serveurs de boîtes aux lettres connectés aux serveurs de transport Edge. Ce paramètre n'est utilisé que si vous exécutez la commande sur un serveur de boîtes aux lettres.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Pour visualiser les types d’entrées acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type d’entrée pour une cmdlet est vide, la cmdlet n’accepte pas les données d’entrée.

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.

 
Afficher: