Get-CsBlockedDomain
Dernière rubrique modifiée : 2012-03-23
Retourne les informations relatives aux domaines inclus dans la liste des domaines bloqués pour fédération. Par définition, vos utilisateurs ne sont pas autorisés à utiliser des applications Microsoft Lync Server 2010 pour communiquer avec les personnes des domaines bloqués. Par exemple, les utilisateurs ne peuvent pas utiliser Microsoft Lync 2010 pour échanger des messages instantanés avec quiconque possédant un compte Session Initiation Protocol (SIP) dans un domaine faisant partie d’une liste bloquée.
Syntaxe
Get-CsBlockedDomain [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsBlockedDomain [-Filter <String>] [-LocalStore <SwitchParameter>]
Description détaillée
La fédération est un moyen par lequel deux organisations peuvent fonder une relation afin de faciliter la communication entre leurs groupes. 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 Lync 2010. 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 de service public, et 3) fédération entre votre organisation et un fournisseur d’hébergement tiers.
Fonder une fédération directe avec une autre organisation implique plusieurs tâches. Pour commencer, vous devez configurer le service Edge d’accès Lync Server pour autoriser la fédération. De plus, l’autre organisation doit accepter de se fédérer avec vous. Une fédération ne peut être établie que si les deux parties ont convenu de cette 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 comprend les organisations avec lesquelles vous avez choisi de vous fédérer. Si un domaine apparaît sur la liste autorisée, alors vos utilisateurs seront capables d’échanger des messages instantanés et des informations de présence avec les utilisateurs qui détiennent un compte dans ce 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-CsBlockedDomain vous permet de retourner des informations sur les domaines qui apparaissent dans la liste des domaines.
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-CsBlockedDomain : 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-CsBlockedDomain"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Facultatif |
Chaîne |
Nom du domaine à retourner. Les domaines figurent sur la liste des personnes bloquées avec leur nom de domaine complet. Ainsi, l’identité d’un domaine donné peut être similaire à fabrikam.com ou contoso.net. Notez que vous ne pouvez pas utiliser de caractères génériques pour spécifier une identité de domaine. Pour utiliser des caractères génériques afin de retourner un domaine donné (ou un ensemble de domaines), utilisez plutôt le paramètre Filtre. À défaut de spécifier ce paramètre, tous les domaines de la liste des domaines bloqués seront retournés. |
Filter |
Facultatif |
Chaîne |
Vous permet d’utiliser des caractères génériques afin de retourner un ou plusieurs domaines faisant partie de la liste des domaines bloqués. Pour retourner tous les domaines ayant une identité qui se termine 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 « f » ou la lettre « g », utilisez cette syntaxe : -Filter [fg]*. |
LocalStore |
Facultatif |
Paramètre de commutateur |
Extrait les données du domaine bloqué à partir du réplica local du magasin central de gestion et non du magasin central de gestion lui-même. |
Types d’entrées
Aucun. Get-CsBlockedDomain 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.BlockedDomain.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsBlockedDomain
La commande présentée dans l’exemple 1 retourne une collection de tous les domaines inclus dans le liste des domaines bloqués. Cette opération s’effectue en appelant la cmdlet Get-CsBlockedDomain sans aucun paramètre supplémentaire.
-------------------------- Exemple 2 --------------------------
Get-CsBlockedDomain -Identity fabrikam.com
Dans l’exemple 2, le seul domaine renvoyé est celui qui contient l’identité « fabrikam.com ». Puisque les domaines de la liste des domaines bloqués doivent avoir des identités uniques, cette commande sera toujours retournée, tout au plus, comme élément unique.
-------------------------- Exemple 3 --------------------------
Get-CsBlockedDomain -Filter *.net
L’exemple 3 utilise le paramètre Filter pour retourner une collection de tous les domaines bloqués ayant une identité finissant par la valeur de chaîne « .net ». Cette commande d’échantillonnage retourne des domaines du type northwindtraders.net, contoso.net et fabrikam.net.
-------------------------- Exemple 4 --------------------------
Get-CsBlockedDomain | Where-Object {$_.Comment -eq $Null}
La commande précédente retourne une collection de tous les domaines pour lesquels la propriété Comment n’a pas de valeur. Pour ce faire, la commande utilise d’abord Get-CsBlockedDomain pour retourner une collection de tous les domaines dans la liste bloquée. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les domaines dont la propriété Comment est égale à une valeur nulle.
-------------------------- Exemple 5 ------------------------
Get-CsBlockedDomain | Where-Object {$_.Comment -match "Ken Myer"}
Dans l’exemple 5, sont renvoyés tous les domaines bloqués avec la valeur de chaîne « Ken Myer » dans la propriété Comment. Pour effectuer cette tâche, on appelle d’abord Get-CsBlockedDomain afin de retourner une collection de tous les domaines de la liste des domaines bloqués. Cette collection est ensuite acheminée vers Where-Object qui choisit les domaines où la propriété Comment contient la valeur de chaîne « Ken Myer ».
Voir aussi
Autres ressources
New-CsBlockedDomain
Remove-CsBlockedDomain
Set-CsAccessEdgeConfiguration
Set-CsBlockedDomain