Get-CsSipDomain
Dernière rubrique modifiée : 2012-03-23
Retourne des informations sur les domaines SIP configurés pour être utilisés 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
Get-CsSipDomain [-Identity <XdsGlobalRelativeIdentity>]
Get-CsSipDomain [-Filter <String>]
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 identifiant 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 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.
La cmdlet Get-CsSipDomain permet de retourner des informations sur les domaines SIP autorisés pour être utilisés dans votre organisation. Get-CsSipDomain identifie également le domaine SIP par défaut de votre organisation. Il s’agit du domaine utilisé par défaut par Microsoft Lync Server 2010 si aucun domaine SIP n’est spécifié.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-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 |
Facultatif |
Chaîne |
Nom de domaine complet (FQDN) du domaine SIP à retourner (exemple : fabrikam.com). Si ni ce paramètre ni le paramètre Filter n’est spécifié, tous les domaines SIP autorisés pour être utilisés dans votre organisation sont retournés. |
Filter |
Facultatif |
Chaîne |
Permet d’utiliser des caractères génériques pour spécifier l’identité du domaine (ou des domaines) SIP à renvoyer. Par exemple, la valeur de filtre *.org retourne une collection de tous les domaines SIP autorisés dont l’identité se termine par la valeur de chaîne .org. |
Types d’entrées
Aucun. Get-CsSipDomain n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Get-CsSipDomain retourne les instances de l’objet Microsoft.Rtc.Management.Xds.SipDomain.
Exemple
-------------------------- Exemple 1 ------------------------
Get-CsSipDomain
Dans l’exemple 1, la cmdlet Get-CsSipDomain est appelée sans paramètres et retourne les informations sur tous les domaines SIP configurés pour être utilisés dans votre organisation.
-------------------------- Exemple 2 ------------------------
Get-CsSipDomain -Identity fabrikam.com
La commande illustrée dans l’exemple 2 retourne des informations sur tous les domaines SIP dont l’identité est fabrikam.com. Étant donné que les identités de domaine SIP doivent être uniques, cette commande ne retournera jamais plus d’un élément.
-------------------------- Exemple 3 ------------------------
Get-CsSipDomain -Filter "f*"
La commande ci-dessus utilise Get-CsSipDomain et le paramètre Filter pour retourner des informations sur les domaines SIP dont l’identité commence par la lettre f. Par exemple : fabrikam.com, fabrikam.org, fabrikam-users.com, etc.
-------------------------- Exemple 4 ------------------------
Get-CsSipDomain | Where-Object {$_.IsDefault -eq $True}
La commande illustrée dans l’exemple 4 retourne des informations sur le domaine SIP par défaut. Pour cela, la cmdlet Get-CsSipDomain est d’abord appelée sans paramètres afin de retourner une collection de tous les domaines SIP configurés pour être utilisés dans votre organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui ne sélectionne que le domaine pour lequel la propriété IsDefault est égale à True..