New-CsSipProxyRealm
Dernière rubrique modifiée : 2012-03-27
Permet d’affecter le domaine par défaut (service de communications SIP) à une collection de paramètres de configuration de proxy. Les domaines (également appelés « domaines de protection ») sont utilisés pour authentifier les informations d’identification de l’utilisateur lors d’une ouverture de session.
Syntaxe
New-CsSipProxyRealm -RealmChoice <IRealmChoice>
Description détaillée
Les serveurs proxy permettent aux utilisateurs situés à l’extérieur de votre réseau interne d’accéder à ses ressources. Chaque serveur proxy doit être associé à un domaine. Les domaines (également appelés « domaines de protection ») indiquent l’emplacement auquel les informations d’identification de connexion d’un utilisateur doivent être traitées. Par défaut, Microsoft Lync Server 2010 utilise le service de communications SIP comme domaine par défaut. Toutefois, il est possible de modifier le réseau employé par un serveur proxy. Les cmdlets New-CsSipProxyUseDefault et New-CsSipProxyCustom vous permettent de modifier le domaine utilisé par un serveur proxy. Vous pouvez également apporter ces modifications à l’aide de la cmdlet New-CsSipProxyRealm. Cependant, parce que cette cmdlet exige une étape supplémentaire, il sera préférable d’utiliser les deux autres cmdlets chaque fois que vous souhaitez modifier le domaine utilisé par un serveur proxy.
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-CsSipProxyRealm : 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-CsSipProxyRealm"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
RealmChoice |
Obligatoire |
Objet SipProxy.IRealmChoice |
Objet représentant le domaine qui doit être utilisé par un serveur proxy. Pour créer le paramètre RealmChoice, utilisez soit la cmdlet New-CsSipProxyUseDefault, soit la cmdlet New-CsSipProxyCustom. |
Types d’entrées
Aucun. New-CsSipProxyRealm n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
New-CsSipProxyRealm crée de nouvelles instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Realm.
Exemple
-------------------------- Exemple 1 ------------------------
$x = New-CsSipProxyUseDefault
$y = New-CsSipProxyRealm -RealmChoice $x
Les commandes présentées dans l’exemple 1 affectent le domaine par défaut (service de communications SIP) à une variable appelée $y. Pour ce faire, la première commande appelle la cmdlet New-CsSipProxyUseDefault afin de créer un objet SipProxy.UseDefault. Cet objet est stocké dans une variable appelée $x.
Dans la deuxième commande, la variable $x sert de valeur de paramètre pour New-CsSipProxyRealm et le paramètre RealmChoice. Un nouvel objet de domaine proxy est alors créé et stocké dans une variable nommée $y.
-------------------------- Exemple 2 ------------------------
$x = New-CsSipProxyCustom -CustomValue "Litwareinc Communications Service"
$y = New-CsSipProxyRealm -RealmChoice $x
Les commandes présentées dans l’exemple 2 affectent un domaine personnalisé (Litwareinc Communications Service) à une variable appelée $y. Pour ce faire, la première commande appelle la cmdlet New-CsSipProxyCustom afin de créer un objet SipProxy.Custom. Cet objet (qui utilise « Litwareinc Communications Service » comme valeur du paramètre CustomValue) est stocké dans une variable appelée $x.
Dans la deuxième commande, la variable $x est utilisée conjointement avec la cmdlet New-CsSipProxyRealm et le paramètre RealmChoice pour créer un nouvel objet de domaine personnalisé.