Partager via

  • Article

Set-CsTrustedApplicationEndpoint

 

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

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

Syntaxe

Set-CsTrustedApplicationEndpoint -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-Enabled <$true | $false>] [-EnabledForFederation <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-PrimaryLanguage <String>] [-SecondaryLanguages <MultiValuedProperty>] [-SipAddress <String>] [-Type <String>] [-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 modifie un objet contact de système d’extrémité existant dans services de domaine Active Directory (AD DS).

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Set-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 "Set-CsTrustedApplicationEndpoint"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Paramètre ID utilisateur

L’identité (nom unique) ou l’adresse SIP du système d’extrémité de l’application à modifier.

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.

Enabled

Facultatif

Booléen

Détermine si le contact est activé sous Lync Server 2010.

Valeur par défaut : True

EnabledForFederation

Facultatif

Booléen

Détermine si les utilisateurs fédérés ont accès à ce contact.

Valeur par défaut : False

EnterpriseVoiceEnabled

Facultatif

Booléen

Détermine si le contact est activé pour Enterprise Voice.

Valeur par défaut : True

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

MultiValuedProperty

Une collection de langues qui peut également être utilisée pour des applications approuvées. Les valeurs doivent être configurées sous forme de liste de valeurs de codes de langue séparées par des virgules. Par exemple, la syntaxe suivante définit le français canadien et le français comme langues secondaires : -SecondaryLanguages "fr-CA","fr-FR".

SipAddress

Facultatif

Chaîne

Vous ne pouvez pas modifier l’adresse SIP d’un contact. L’adresse SIP est affectée lors de la création du système d’extrémité de l’application.

Type

Facultatif

Chaîne

Ce paramètre n’est pas utilisé avec cette cmdlet.

PassThru

Facultatif

Paramètre de commutateur

L’insertion de ce paramètre obligera non seulement la cmdlet à modifier l’objet contact mais également à retourner le nouvel objet comme résultat.

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

Objet Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact. Accepte la saisie de données transmises via le pipeline pour les objets de système d’extrémité pour application approuvée.

Types de retours

Cette cmdlet ne retourne aucune valeur. Elle modifie un objet de type Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.

Exemple

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

Set-CsTrustedApplicationEndpoint -Identity "sip:endpoint1@litwareinc.com" -DisplayName "Endpoint 1"

Cet exemple modifie l’objet contact du système d’extrémité de l’application avec l’adresse SIP endpoint1@litwareinc.com. Notez que la valeur d’identité commence par la chaîne « sip: » suivie de l’adresse SIP. Le paramètre suivant, DisplayName, est une valeur donnée « Endpoint 1 » qui modifie le nom complet du contact affecté à cette valeur.

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

Get-CsTrustedApplicationEndpoint -Identity "Endpoint 1" | Set-CsTrustedApplicationEndpoint -DisplayNumber "(425)555-1212"

Cet exemple modifie le numéro complet de l’application du système d’extrémité avec le nom complet EndPoint 1. La commande appelle d’abord Get-CsTrustedApplicationEndpoint avec l’identité Endpoint 1. Cela permet de récupérer l’objet contact du système d’extrémité avec ce nom complet. Cet objet est ensuite redirigé vers la cmdlet Set-CsTrustedApplicationEndpoint qui modifie DisplayNumber pour lui donner la valeur correspondante (dans le cas présent, (425)555-1212).