New-CsSipDomain
Dernière rubrique modifiée : 2012-03-27
Crée un domaine SIP à utiliser 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
New-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 la forêt Active Directory, et autorisé à 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.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet New-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 "New-CsSipDomain"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
Chaîne |
Nom de domaine complet du nouveau domaine SIP. 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 ce paramètre est défini sur True, le nouveau domaine sera également le domaine par défaut. La valeur par défaut pour IsDefault est False. Si vous ne souhaitez pas que le nouveau domaine soit le domaine par défaut, vous pouvez laisser ce paramètre de côté. |
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. New-CsSipDomain n’accepte pas les données transmises via le pipeline.
Types de retours
New-CsSipDomain crée des instances de l’objet Microsoft.Rtc.Management.Xds.SipDomain.
Exemple
-------------------------- Exemple 1 ------------------------
New-CsSipDomain -Identity fabrikam.com
La commande illustrée dans l’exemple 1 crée un domaine SIP, dont le paramètre Identity est fabrikam.com.
-------------------------- Exemple 2 ------------------------
New-CsSipDomain -Identity fabrikam.com -IsDefault $True
La commande ci-dessus crée un domaine SIP nommé fabrikam.com et le définit comme domaine SIP par défaut. En faisant de fabrikam.com le domaine par défaut, cette commande rétrograde le domaine qui servait auparavant de domaine SIP par défaut. C’est la raison pour laquelle il n’est possible d’avoir qu’un seul domaine SIP par défaut.