Set-CsSipDomain
Dernière rubrique modifiée : 2012-03-27
Vous permet de modifier les valeurs de propriété des domaines SIP de 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
Set-CsSipDomain [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-IsDefault <$true | $false>] [-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.
Un domaine SIP doit toujours être configuré comme domaine par défaut. La cmdlet Set-CsSipDomain vous offre le moyen de modifier votre domaine SIP par défaut.
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-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 "Set-CsSipDomain"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
Chaîne |
Nom de domaine complet (FQDN) du domaine SIP à configurer comme domaine par défaut. Par exemple : -Identity fabrikam.com. |
IsDefault |
Facultatif |
Booléen |
Indique si le domaine est le domaine SIP par défaut, c'est-à-dire le domaine utilisé par Lync Server 2010 lorsqu'aucun nom de domaine n'est explicitement cité. Si le paramètre est défini sur True, le domaine devient le nouveau domaine par défaut. Vous ne pouvez pas définir cette valeur sur False, car il vous manquerait un domaine SIP par défaut. |
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
Aucun. Set-CsSipDomain n'accepte pas les données transmises via le pipeline.
Types de retours
Set-CsSipDomain ne renvoie ni valeur ni objet. La cmdlet permet plutôt de modifier des instances existantes de l'objet Microsoft.Rtc.Management.Xds.SipDomain.
Exemple
-------------------------- Exemple 1 ------------------------
Set-CsSipDomain -Identity fabrikam.com -IsDefault $True
La commande illustrée dans l'exemple 1 définit le domaine SIP fabrikam.com comme domaine par défaut. Cette opération est effectuée à l'aide du paramètre IsDefault et de la valeur de paramètre $True. Lorsque cette commande est exécutée, Fabrikam.com devient le domaine par défaut et le domaine précédemment utilisé comme domaine par défaut est « rétrogradé ». C'est la raison pour laquelle il n'est possible d'avoir qu'un seul domaine par défaut.