Get-UMIPGateway

 

S’applique à :Exchange Online, Exchange Server 2016

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

Cette cmdlet est disponible dans Exchange Server 2016 sur site et dans le service en nuage. Certains paramètres peuvent être propres à un environnement ou à un autre.

La cmdlet Get-UMIPGateway permet de renvoyer une liste des propriétés et des valeurs d'une passerelle IP de messagerie unifiée spécifiée ou une liste de passerelles IP de messagerie unifiée.

Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir SyntaxeSyntaxe de cmdlet Exchange.

Get-UMIPGateway [-Identity <UMIPGatewayIdParameter>] [-DomainController <Fqdn>] [-IncludeSimulator <SwitchParameter>]

Cet exemple affiche une liste mise en forme de toutes les passerelles IP de messagerie unifiée dans la forêt Active Directory.

Get-UMIPGateway | Format-List

Cet exemple de code affiche les propriétés d’une passerelle IP de messagerie unifiée nommée MyUMIPGateway.

Get-UMIPGateway -Identity MyUMIPGateway

Cet exemple affiche toutes les passerelles IP de messagerie unifiée, y compris les simulateurs de passerelle IP dans la forêt Active Directory.

Get-UMIPGateway -IncludeSimulator $true

La cmdlet Get-UMIPGateway affiche les propriétés et les valeurs d’une passerelle IP de messagerie unifiée spécifiée, telles que les paramètres de nom d’affichage, d’adresse IP, d’état et d’appels sortants. Si aucun paramètre n'est spécifié, toutes les passerelles IP de messagerie unifiée de la forêt Active Directory sont renvoyées.

Lorsque vous utilisez la cmdlet Get-UMIPGateway, vous ne pouvez pas entrer l’adresse IP configurée sur la passerelle IP de messagerie unifiée. Vous devez utiliser le nom de la passerelle IP de messagerie unifiée. Le nom spécifié avec le paramètre Identity de la cmdlet Get-UMIPGateway peut être identique ou différent du nom hôte de l’adresse IP de messagerie unifiée, par exemple, Get-UMIPGatewayMyUMIPGateway.

Une fois cette tâche terminée, vous pouvez afficher la liste des propriétés et des valeurs d’une passerelle IP de messagerie unifiée spécifique. Ou, si le paramètre Identity n'est pas utilisé, la cmdlet renvoie une liste de toutes les passerelles IP de messagerie unifiée de la forêt.

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 Entrée « Passerelles IP de messagerie unifiée » dans la rubrique Autorisations de messagerie unifiée.

 

Paramètre Obligatoire Type Description

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

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.

Identity

Facultatif

Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter

Le paramètre Identity spécifie l'identificateur de la passerelle IP de messagerie unifiée en cours d'affichage. Ce paramètre est l'identificateur d'objet d'annuaire pour la passerelle IP de messagerie unifiée.

IncludeSimulator

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur IncludeSimulator récupère le simulateur de la passerelle IP de messagerie unifiée en cours d’affichage. Un simulateur permet à un client de se connecter au serveur de boîtes aux lettres.

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: