Partager via

  • Article

New-CsTrustedApplicationEndpoint

 

Dernière rubrique modifiée : 2012-03-25

Crée un contact de système d’extrémité pour une application approuvée.

Syntaxe

New-CsTrustedApplicationEndpoint -ApplicationId <String> -TrustedApplicationPoolFqdn <Fqdn> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-PrimaryLanguage <String>] [-SecondaryLanguages <MultiValuedProperty>] [-SipAddress <String>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Le système d’extrémité d’une application approuvée est un objet contact Active Directory qui permet d’acheminer des appels vers une application approuvée. Cette cmdlet crée un objet contact de système d’extrémité dans services de domaine Active Directory (AD DS) pour une application spécifique.

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-CsTrustedApplicationEndpoint : 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-CsTrustedApplicationEndpoint"}

Paramètres

Paramètre Obligatoire Type Description

ApplicationId

Obligatoire

Chaîne

L’ID de l’application de confiance pour lequel le contact de système d’extrémité a été crée. Une application avec cette ID doit déjà exister. Notez que vous pouvez n’inclure que la partie du nom de l’ID d’application, il n’est pas nécessaire d’inclure l’information concernant le préfixe. Par exemple, si l’identificateur d’application est urn:application:TrustedApp1 vous ne devez que transférer la chaîne TrustedApp1 à ce paramètre.

TrustedApplicationPoolFqdn

Obligatoire

FQDN

Le nom de domaine complet (FQDN) du pool d’applications approuvées associé à cette application. L’application doit déjà être associée à ce pool pour le système d’extrémité à créer.

SipAddress

Facultatif

Chaîne

Une adresse SIP pour le nouvel objet de contact. Si vous n’incluez pas une valeur pour ce paramètre, une adresse SIP sera générée automatiquement au format sip:RtcApplication-<GUID>.<domaine>, par exemple RtcApplication-fbf9e2d1-c6aa-45a3-a045-b92d4ef961b2@litwareinc.com. Le domaine sera le domaine SIP par défaut.

DisplayName

Facultatif

Chaîne

Nom complet de l’objet contact du système d’extrémité.

DisplayNumber

Facultatif

Chaîne

Numéro de téléphone du contact tel qu’il apparaîtra dans le carnet d’adresses.

LineURI

Facultatif

Chaîne

Numéro de téléphone du contact. Doit être au format TEL:<numéro> (par exemple, TEL:+14255551212).

PrimaryLanguage

Facultatif

Int32

La principale langue utilisée pour l’application approuvée. La langue doit être configurée à l’aide d’un code linguistique valide, tel que en-US (anglais américain), fr-FR (français), etc.

SecondaryLanguages

Facultatif

Int32[]

Il est également possible d’utiliser une collection de langues pour les applications approuvées. Les valeurs doivent être configurées sous la forme d’une liste de codes linguistiques séparés par une virgule. Par exemple, la syntaxe suivante définit le français canadien et le français comme langues secondaires : -SecondaryLanguages "fr-CA","fr-FR".

Tenant

Facultatif

GUID

Identificateur global unique (GUID) de l’objet. Ce paramètre n’est pas utilisé pour des déploiements sur site.

PassThru

Facultatif

Paramètre de commutateur

Renvoie les résultats de cette commande. L’exécution de cette cmdlet entraînera l’affichage du nouvel objet créé. L’ajout de ce paramètre répétera simplement ce résultat, rendant ainsi redondante l’utilisation de ce paramètre.

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.

Types de retours

Crée un objet de type Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.

Exemple

-------------------------- Exemple 1 --------------------------

New-CsTrustedApplicationEndpoint -ApplicationId tapp1 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com

Cet exemple crée un système d’extrémité pour l’application approuvée avec l’identificateur de l’application ID tapp 1 hébergée par le pool TrustPool.litwareinc.com. ApplicationID et TrustedApplicationPoolFqdn sont les seuls paramètres requis pour créer le système d’extrémité d’une application approuvée. Cependant, gardez à l’esprit qu’assigner des valeurs à ces deux paramètres uniquement générera automatiquement une adresse SIP pour le contact. Afin de s’assurer que l’adresse SIP est unique, l’adresse générée automatiquement inclut un identificateur unique global (GUID) pour ressembler à ceci : sip:RtcApplication-fbf9e2d1-c6aa-45a3-a045-b92d4ef961b2@litwareinc.com. Si vous souhaitez une adresse SIP un peu plus lisible, consultez l’exemple 2.

-------------------------- Exemple 2 --------------------------

New-CsTrustedApplicationEndpoint -ApplicationId tapp1 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com -SipAddress sip:endpoint1@litwareinc.com

L’exemple 2 est identique à l’exemple 1 en ce sens qu’il crée un système d’extrémité pour l’application approuvée avec l’identité ID tapp1 sur le pool TrustPool.litwareinc.com. Contrairement à l’exemple 1, nous incluons un paramètre de plus pour créer notre système d’extrémité : SipAddress. Plutôt que d’autoriser le système à générer une adresse SIP, nous avons spécifié une adresse endpoint1@litwareinc.com.