.png)
New-CsSipProxyRealm
Dernière rubrique modifiée : 2013-02-21
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. Cette applet de commande est une nouveauté de Lync Server 2010.
New-CsSipProxyRealm -RealmChoice <IRealmChoice>
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 l’applet de commande 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 l’applet de commande New-CsSipProxyRealm et le paramètre RealmChoice. Un nouvel objet de domaine proxy est alors créé et stocké dans une variable appelée $y.
$x = New-CsSipProxyUseDefault $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 l’applet de commande 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 l’applet de commande New-CsSipProxyRealm et le paramètre RealmChoice pour créer un nouvel objet de domaine personnalisé.
$x = New-CsSipProxyCustom -CustomValue "Litwareinc Communications Service" $y = New-CsSipProxyRealm -RealmChoice $x
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, Lync Server 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. L’applet de commande New-CsSipProxyUseDefault et l’applet de commande New-CsSipProxyCustom vous permettent de modifier le domaine utilisé par un serveur proxy. Vous pouvez également apporter ces modifications à l’aide de l’applet de commande New-CsSipProxyRealm. Cependant, parce que cette applet de commande exige une étape supplémentaire, il sera préférable d’utiliser les deux autres applets de commande chaque fois que vous souhaitez modifier le domaine utilisé par un serveur proxy.
Personnes autorisées à exécuter cette applet de commande : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement l’applet de commande 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 applet de commande 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ètre | Obligatoire | Type | Description |
|---|---|---|---|
| RealmChoice | Obligatoire | Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.IRealmChoice | Objet représentant le domaine qui doit être utilisé par un serveur proxy. Pour créer le paramètre RealmChoice, utilisez soit l’applet de commande New-CsSipProxyUseDefault, soit l’applet de commande New-CsSipProxyCustom. |
Aucun. L’applet de commande New-CsSipProxyRealm n’accepte pas l’entrée redirigée.
L’applet de commande New-CsSipProxyRealm crée de nouvelles instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Realm.
