Partager via

  • Article

Set-CsBlockedDomain

 

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

Modifie la propriété Comment d'un ou plusieurs domaines figurant dans la liste de domaines dont la fédération est bloquée. Par définition, les utilisateurs ne sont pas autorisés à utiliser des applications Microsoft Lync Server 2010 pour communiquer avec des personnes du domaine bloqué. Par exemple, les utilisateurs ne peuvent pas employer Microsoft Lync 2010 pour échanger des messages instantanés avec un utilisateur disposant d’un compte SIP dans un domaine apparaissant sur la liste bloquée.

Syntaxe

Set-CsBlockedDomain [-Identity <XdsGlobalRelativeIdentity>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Set-CsBlockedDomain [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<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 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 public et 3) fédération entre votre organisation et un fournisseur d’hébergement tiers.

La configuration de la fédération directe avec une autre organisation implique plusieurs tâches. Pour commencer, vous devez activer vos serveurs Edge d’accès pour autoriser la fédération. De plus, 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 représente les organisations avec lesquelles vous avez choisi d’établir une fédération. Si un domaine figure dans la liste autorisée, les utilisateurs pourront échanger des messages instantanés et des informations de présence avec d’autres utilisateurs disposant de comptes dans ce domaine fédéré (en fonction de vos paramètres de configuration). 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 propriété Comment, la seule d'un domaine bloqué pouvant être modifiée, permet de stocker des informations supplémentaires sur un domaine de la liste bloquée (par exemple, la raison du blocage du domaine, la date à laquelle le domaine peut être supprimé de la liste bloquée ou la personne à contacter pour faire supprimer le domaine de la liste bloquée). Si vous souhaitez modifier la propriété Comment relative à un domaine figurant dans la liste des domaines bloqués, utilisez la cmdlet Set-CsBlockedDomain.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Set-CsBlockedDomain : 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 "Set-CsBlockedDomain"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Chaîne

Nom de domaine complet (FQDN) d'un domaine bloqué pour lequel la propriété Comment est modifiée. Par exemple : fabrikam.com

Instance

Facultatif

Objet BlockedDomain

Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles.

Comment

Facultatif

Chaîne

Permet de fournir des informations supplémentaires sur le domaine modifié. Par exemple, vous pouvez ajouter un commentaire indiquant la raison pour laquelle le domaine a été mis sur la liste bloquée.

Force

Facultatif

Paramètre de commutateur

Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande.

WhatIf

Facultatif

Paramètre de commutateur

Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement.

Confirm

Facultatif

Paramètre de commutateur

Vous demande confirmation avant d’exécuter la commande.

Types d’entrées

Objet Microsoft.Rtc.Management.WritableConfig.Settings.Edge.BlockedDomain. Set-CsBlockedDomain accepte les instances transmises via le pipeline de l’objet domaine bloqué.

Types de retours

Set-CsBlockedDomain ne renvoie ni valeur ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Edge.BlockedDomain.

Exemple

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

Set-CsBlockedDomain -Identity fabrikam.com -Comment "Block this domain pending legal review."

La commande illustrée dans l’exemple 1 modifie la propriété Comment relative au domaine bloqué dont l’identité est « fabrikam.com ». Dans cet exemple, le paramètre Comment est inclus avec la valeur de paramètre « Bloquer ce domaine en cours de révision légale ».

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

Get-CsBlockedDomain | Set-CsBlockedDomain -Comment "Block this domain pending legal review."

Dans l’exemple précédent, la propriété Comment est mise à jour pour tous les domaines figurant dans la liste des domaines bloqués. Pour cela, la commande appelle d’abord la cmdlet Get-CsBlockedDomain, qui renvoie un ensemble de tous les domaines actuellement inscrits dans la liste des domaines bloqués. Cet ensemble est ensuite redirigé vers Set-CsBlockedDomain, qui modifie la propriété Comment de chaque domaine.

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

Get-CsBlockedDomain | Where-Object {$_.Comment -eq $Null} | Set-CsBlockedDomain -Comment "Block this domain pending legal review."

Dans l’exemple 3, un nouveau commentaire (« Bloquer ce domaine en cours de révision légale ») est ajouté à chaque domaine figurant dans la liste bloquée et dont la propriété Comment n’est pas encore associée à une valeur. Pour exécuter cette tâche, la commande appelle d’abord Get-CsBlockedDomain, qui renvoie un ensemble de tous les domaines actuellement répertoriés dans la liste bloquée. Cet ensemble est ensuite redirigé vers la cmdlet Where-Object, qui sélectionne uniquement les domaines dont la propriété Comment est égale à une valeur null. L’ensemble filtré est ensuite redirigé vers la cmdlet Set-CsBlockedDomain, qui affecte le même commentaire dans la propriété Comment de chaque domaine appartenant à l’ensemble.