Set-CsAllowedDomain

Syntaxe

Set-CsAllowedDomain [-Identity <XdsGlobalRelativeIdentity>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-MarkForMonitoring <$true | $false>] [-ProxyFqdn <String>] [-WhatIf [<SwitchParameter>]]

Set-CsAllowedDomain [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MarkForMonitoring <$true | $false>] [-ProxyFqdn <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La fédération est le moyen par lequel deux organisations peuvent configurer une relation d’approbation pour faciliter 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 de la fédération directe avec une autre organisation implique plusieurs tâches. Pour commencer, vous devez activer vos serveurs exécutant le service Edge d'accès Lync Server pour autoriser la fédération. En outre, l’autre organisation doit permettre la fédération avec vous ; la fédération ne peut pas être établie si les deux parties ne sont pas d’accord.

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 décidé de vous fédérer. 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 Set-CsAllowedDomain vous permet de modifier les valeurs de propriété de tout domaine 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 Set-CsAllowedDomain : 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-CsAllowedDomain"}

Paramètres

Types d’entrées

Objet Microsoft.Rtc.Management.WritableConfig.Settings.Edge.AllowedDomain. Set-CsAllowedDomain accepte les instances transmises via le pipeline de l'objet de type domaine autorisé.

Types de retours

Set-CsAllowedDomain ne retourne ni valeur ni objet. Au lieu de cela, la cmdlet configure les instances de l'objet Microsoft.Rtc.Management.WritableConfig.Settings.Edge.AllowedDomain.

Exemple

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

Set-CsAllowedDomain -Identity fabrikam.com -Comment "Contact: Ken Myer (kenmyer@fabrikam.com)"

La commande présentée dans l’exemple 1 modifie la propriété Comment du domaine autorisé dont l’identité est « fabrikam.com ». Cette opération s'effectue en incluant le paramètre Comment et la valeur de paramètre appropriée : « Contact: Ken Myer (kenmyer@fabrikam.com) ».

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

Get-CsAllowedDomain -Filter *fabrikam* | Set-CsAllowedDomain -Comment "Contact: Ken Myer (kenmyer@fabrikam.com)" -MarkForMonitoring $True

La commande précédente modifie les propriétés Comment et MarkForMonitoring de tous les domaines autorisés qui comportent la valeur de chaîne « fabrikam » dans leur identité. Pour effectuer cette tâche, la commande appelle d'abord Get-CsAllowedDomain ainsi que le paramètre Filter. la valeur de filtre "*fabrikam*" demande à Get-CsAllowedDomain de retourner tous les domaines dont l'identité contient la valeur de chaîne "fabrikam". (Par exemple, cette commande retourne les domaines tels que fabrikam.com, us.fabrikam.net et fabrikam-users.org). La collection filtrée est ensuite redirigée vers Set-CsAllowedDomain, qui modifie la propriété Comment et définit la propriété MarkForMonitoring sur True ($True) pour chaque élément de la collection.

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

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

La commande présentée dans l'exemple 3 modifie tous les domaines de la liste autorisée qui ne sont actuellement pas surveillés par le serveur de surveillance. (c'est-à-dire, tous les domaines pour lesquels la propriété MarkForMonitoring est définie à False.) Pour cela, le système appelle d'abord Get-CsAllowedDomain sans paramètre supplémentaire, afin de récupérer une collection de tous les domaines présents dans la liste autorisée. Cette collection est redirigée vers la cmdlet Where-Object, qui ne sélectionne que les domaines dont la propriété MarkForMonitoring est égale à False. La collection filtrée est ensuite redirigée vers Set-CsAllowedDomain, qui attribue la valeur True à la propriété MarkForMonitoring de chaque domaine de la collection.

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

Get-CsAllowedDomain | Where-Object {$_.Comment -eq $Null} | Set-CsAllowedDomain -Comment "Need contact information."

L’exemple 4 ajoute un commentaire générique (« Need contact information. ») à chaque domaine de la liste autorisée pour lequel aucune valeur n’est attribuée à la propriété Comment. Pour effectuer cette tâche, la commande appelle d'abord Get-CsAllowedDomain afin de récupérer une collection de tous les domaines présents dans la liste autorisée. Cette collection est ensuite redirigée vers Where-Object, qui sélectionne les domaines dont la propriété Comment a la valeur Null. Cette collection filtrée est alors redirigée vers Set-CsAllowedDomain, qui modifie la propriété Comment de chaque élément contenu dans la collection.

Voir aussi

Autres ressources

Get-CsAllowedDomain
New-CsAllowedDomain
Remove-CsAllowedDomain
Set-CsAccessEdgeConfiguration