Remove-CsSipDomain
Dernière rubrique modifiée : 2012-03-27
Supprime un domaine SIP précédemment configuré pour être utilisé dans votre organisation. Les domaines SIP sont des domaines autorisés à envoyer et recevoir du trafic SIP et sont utilisés au moment d'affecter des adresses SIP aux utilisateurs.
Syntaxe
Remove-CsSipDomain -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Afin de configurer des adresses SIP pour vos utilisateurs (et leur permettre ainsi d'utiliser des logiciels basés sur le protocole SIP, tels que Microsoft Lync 2010), vous devez disposer de deux éléments : un ID d'utilisateur (par exemple, Ken.Myer) et un domaine SIP (par exemple, litwareinc.com). Le domaine SIP utilisé pour créer une adresse SIP doit être situé dans votre forêt Active Directory, qui doit être autorisée à envoyer et à recevoir du trafic SIP. Par exemple, vous avez des domaines appelés litwareinc.com, fabrikam.com et contoso.com, mais seul litwareinc.com a été identifié comme domaine SIP. Dans ce cas, vous ne pouvez pas utiliser une adresse SIP comme sip:Ken.Myer@fabrikam.com ou sip:Ken.Myer@contoso.com, tout du moins tant que fabrikam.com et contoso.com n'ont pas été configurés en tant que domaines SIP valides. Vous devez pour cela exécuter la cmdlet New-CsSipDomain.
Une fois qu'un domaine SIP a été autorisé, il peut être « interdit » via la cmdlet Remove-CsSipDomain. Cette cmdlet retire le domaine spécifié de la liste des domaines SIP approuvés. Notez néanmoins que vous ne pouvez pas supprimer le domaine par défaut ; si vous souhaitez effectuer cette opération, vous devez d'abord configurer un autre domaine SIP en tant que domaine par défaut. Si vous ne disposez que d'un seul domaine SIP, ce domaine sera automatiquement configuré en tant que domaine par défaut et vous ne pourrez pas le supprimer.
De plus, vous ne pouvez pas supprimer de domaine SIP auquel sont attribuées une ou plusieurs adresses SIP. Vous ne pouvez par exemple pas supprimer Contoso.com en tant que domaine SIP si Ken Myer a l'adresse SIP "sip:kenmyer@contoso.com". Pour supprimer un domaine SIP en cours d'utilisation, vous devez tout d'abord attribuer de nouvelles adresses SIP à tous les utilisateurs dont l'adresse SIP contient ce nom de domaine.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Remove-CsSipDomain : 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 "Remove-CsSipDomain"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
Chaîne |
Nom de domaine complet (FQDN) du domaine SIP à supprimer : Par exemple : -Identity fabrikam.com. |
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.Xds.SipDomain. Remove-CsSipDomain accepte les instances transmises via le pipeline de l'objet de type domaine SIP.
Types de retours
Aucun. Au lieu de cela, Remove-CsSipDomain supprime l'instance existante de l'objet Microsoft.Rtc.Management.Xds.SipDomain.
Exemple
-------------------------- Exemple 1 ------------------------
Remove-CsSipDomain -Identity fabrikam.com
La commande précédente supprime le domaine SIP ayant l'identité fabrikam.com de la liste des noms de domaine pris en charge. Veuillez noter que cette commande échouera si fabrikam.com est le seul domaine SIP actuellement utilisé dans votre organisation. Ceci est dû au fait que votre topologie doit inclure au moins un domaine SIP.
-------------------------- Exemple 2 ------------------------
Get-CsSipDomain | Where-Object {$_.IsDefault -ne $True} | Remove-CsSipDomain
La commande présente dans l'exemple 2 supprime tous les domaines SIP de votre organisation, à l'exception du domaine par défaut. Pour effectuer cette opération, la commande appelle d'abord Get-CsSipDomain de façon à retourner une collection de tous vos domaines SIP. Cette collection est ensuite redirigée vers la cmdlet Where-Object, qui sélectionne uniquement les domaines dans lesquels la propriété IsDefault n'est pas égale à True. Résultat : le domaine par défaut est éliminé par filtrage et les domaines restants sont ensuite redirigés vers Remove-CsSipDomain, puis supprimés.