Partager via

  • Article

Get-CsAllowedDomain

 

Dernière rubrique modifiée : 2012-03-23

Retourne des informations sur les domaines figurant dans la liste des domaines approuvés pour la fédération. Dès qu’un domaine est approuvé pour la fédération (en l’ajoutant à la liste autorisée), les utilisateurs peuvent échanger des messages instantanés et des informations de présence avec les personnes disposant de comptes dans ce domaine.

Syntaxe

Get-CsAllowedDomain [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsAllowedDomain [-Filter <String>] [-LocalStore <SwitchParameter>]

Description détaillée

La fédération est un moyen par lequel deux organisations peuvent configurer une relation d’approbation destinée à simplifier la communication entre elles. Lorsqu’une fédération a été établie, les utilisateurs des deux organisations peuvent échanger des messages instantanés, souscrire à des notifications de présence et communiquer entre eux à l’aide d’applications SIP comme Microsoft Lync 2010. Microsoft Lync Server 2010 autorise trois types de fédération : 1) fédération directe entre votre organisation et une autre ; 2) fédération entre votre organisation et un fournisseur public ; et 3) fédération entre votre organisation et un fournisseur d’hébergement tiers.

La configuration d’une fédération directe avec une autre organisation implique d’exécuter plusieurs tâches. Pour commencer, vous devez activer vos serveurs Edge d’accès pour autoriser la fédération. En outre, l’organisation doit autoriser la fédération avec l’autre partie. La fédération ne peut être établie que si les deux parties acceptent la relation.

Pour configurer une relation fédérée, vous devrez peut-être également gérer deux listes de fédération : la liste autorisée et la liste bloquée. La liste autorisée (obligatoire si EnablePartnerDiscovery a été désactivé) contient les organisations avec lesquelles vous avez décidé d’établir une fédération. Si un domaine figure dans la liste autorisée (en fonction de vos paramètres de configuration), vos utilisateurs peuvent échanger des messages instantanés et des informations de présence avec les utilisateurs disposant de comptes dans le domaine fédéré. Inversement, la liste bloquée représente les domaines avec lesquels les utilisateurs sont expressément interdits de toute fédération. Ainsi, les messages envoyés depuis un domaine bloqué seront automatiquement rejetés par Lync Server 2010.

La cmdlet Get-CsAllowedDomain vous permet de renvoyer des informations sur tous les domaines figurant dans la liste des domaines autorisés.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsAllowedDomain : RTCUniversalUserAdmins, RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAllowedDomain"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

Chaîne

Nom du domaine à renvoyer. Les domaines sont répertoriés dans la liste verte par nom de domaine complet (FQDN). Ainsi, l’identité d’un domaine donné sera similaire à fabrikam.com ou contoso.net. Notez qu’il n’est pas possible d’utiliser des caractères génériques pour spécifier une identité de domaine. Pour utiliser des caractères génériques afin de renvoyer à un domaine donné (ou un ensemble de domaines), utilisez plutôt le paramètre Filtre.

Si ce paramètre n’est pas spécifié, tous les domaines figurant dans la liste de domaines autorisés seront renvoyés.

Filter

Facultatif

Chaîne

Vous permet d’utiliser des caractères génériques pour renvoyer un ou plusieurs domaines de la liste de domaines autorisés. Pour retourner tous les domaines dont l’identité commence par la lettre « r », utilisez cette syntaxe : -Filter r*. Pour retourner tous les domaines ayant une identité qui se termine par « .net », utilisez cette syntaxe : -Filter "*.net". Pour retourner tous les domaines ayant une identité qui commence par la lettre « r » ou la lettre « g », utilisez cette syntaxe : -Filter [rg]*.

LocalStore

Facultatif

Paramètre de commutateur

Récupère les domaines autorisés depuis la réplique locale du magasin central de gestion plutôt que depuis le magasin central de gestion lui-même.

Types d’entrées

Aucun. Get-CsAllowedDomain n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

Retourne des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Edge.AllowedDomain.

Exemple

-------------------------- Exemple 1 ------------------------

Get-CsAllowedDomain

La commande ci-dessus retourne une collection de tous les domaines figurant dans la liste des domaines approuvés pour fédération. L’appel de Get-CsAllowedDomain sans paramètre supplémentaire entraînera toujours le renvoi de l’ensemble complet de domaines approuvés.

-------------------------- Exemple 2 ------------------------

Get-CsAllowedDomain -Identity fabrikam.com

L’exemple 2 retourne des informations sur le domaine autorisé comportant l’identité « fabrikam.com ». Parce que les identités doivent être uniques, cette commande ne renverra jamais plus d’un élément.

-------------------------- Exemple 3 ------------------------

Get-CsAllowedDomain -Filter *fabrikam*

La commande illustrée dans l’exemple 3 retourne une collection de tous les domaines autorisés dont l’identité contient exclusivement la valeur de chaîne « fabrikam ». Pour cela, la commande utilise le paramètre Filter avec la valeur « *fabrikam* ». Cette valeur indique à Get-CsAllowedDomain que seuls les domaines dont la propriété Identité (la seule sur laquelle le filtrage peut être basé) inclut la valeur de chaîne « fabrikam ». Les domaines, tels que fabrikam.com, fabrikam.net et africa.fabrikam.org seront tous renvoyés par cette commande.

-------------------------- Exemple 4 ------------------------

Get-CsAllowedDomain | Where-Object {$_.ProxyFqdn -eq $Null}

Dans l’exemple 4, les cmdlets Get-CsAllowedDomain et Where-Object sont utilisées pour renvoyer un ensemble de tous les domaines pour lesquels aucune valeur n’a été attribuée à la propriété ProxyFqdn. Pour exécuter cette tâche, on appelle d’abord la cmdlet Get-CsAllowedDomain (sans aucun paramètre supplémentaire) pour renvoyer un ensemble de tous les domaines autorisés. Cette collection est redirigée vers la cmdlet Where-Object, qui sélectionne exclusivement ceux dont la propriété ProxyFqdn est égale à une valeur null. Une valeur null signifie qu’aucune valeur n’a été saisie pour ProxyFqdn. Pour rechercher tous les domaines pour lesquels une valeur a été configurée pour la propriété ProxyFqdn, utilisez plutôt cette syntaxe :

Where-Object {$_.ProxyFqdn -ne $Null}

-------------------------- Exemple 5 ------------------------

Get-CsAllowedDomain | Where-Object {$_.MarkForMonitoring -eq $True}

La commande ci-dessus retourne tous les domaines autorisés dont l’état d’intégrité a été vérifié par le serveur de surveillance. Pour ce faire, on utilise d’abord la cmdlet Get-CsAllowedDomain pour renvoyer un ensemble de tous les domaines répertoriés dans la liste des domaines approuvés. Cet ensemble est ensuite redirigé vers la cmdlet Where-Object, qui sélectionne uniquement les domaines dont la propriété MarkForMonitoring est égale à True.