Partager via


Get-CsUCPhoneConfiguration

 

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

Renvoie des informations concernant les options de gestion de Microsoft Lync 2010 Phone Edition, parmi lesquelles le mode de sécurité désiré et le verrouillage automatique ou non du téléphone après une période d’inactivité donnée.

Syntaxe

Get-CsUCPhoneConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsUCPhoneConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Description détaillée

Lync 2010 Phone Edition représente la fusion du téléphone et de Microsoft Lync 2010. Lync 2010 Phone Edition utilise un matériel spécial (c’est-à-dire un téléphone compatible avec Lync 2010) capable de fonctionner en mode VoIP (Voice over Internet Protocol). De plus, ce matériel peut également servir de système d’extrémité de type Lync 2010 : vous pouvez définir votre statut actuel, vérifier le statut de vos contacts Lync 2010, rechercher de nouveaux contacts et réaliser de nombreuses autres opérations habituellement effectuées dans Lync 2010.

Les cmdlets CsUCPhoneConfiguration vous permettent de gérer vos téléphones Lync 2010. Par exemple, vous pouvez contrôler certains aspects, tels que la longueur minimale du code confidentiel utilisé pour vous connecter au téléphone et déterminer si le téléphone doit ou non se verrouiller automatiquement après une période d’inactivité donnée.

Vous pouvez appliquer des paramètres de configuration de téléphonie dans l’étendue globale ou Site (les paramètres appliqués au niveau de l’étendue Site prévalent sur ceux appliqués au niveau de l’étendue globale). La cmdlet Get-CsUCPhoneConfiguration vous permet d’extraire des informations sur les paramètres de téléphonie actuellement utilisés dans votre organisation.

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-CsUCPhoneConfiguration : RTCUniversalUserAdmins, 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 "Get-CsUCPhoneConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Indique l’identificateur unique de la collection de paramètres de configuration de téléphonie UC que vous souhaitez renvoyer. Pour vous référer aux paramètres globaux, utilisez cette syntaxe : -Identity global. Pour vous référer à une collection configurée au niveau de l’étendue Site, utilisez une syntaxe similaire à celle-ci : -Identity "site:Redmond". Notez que les caractères génériques ne sont pas autorisés pour spécifier une identité. Si vous souhaitez utiliser des caractères génériques, ajoutez plutôt le paramètre Filter.

Si ce paramètre n’est pas spécifié, Get-CsUCPhoneConfiguration renverra une collection de tous les paramètres de configuration de téléphonie UC utilisés dans votre organisation.

Filter

Facultatif

Chaîne

Vous permet d’utiliser des caractères génériques afin de renvoyer une ou plusieurs collections de paramètres de configuration de téléphonie UC. Pour renvoyer une collection de tous les paramètres configurés dans l’étendue Site, utilisez la syntaxe suivante : -Filter site:*. Pour renvoyer une collection de tous les paramètres dont l’identité contient la valeur de chaîne « EMEA » (la seule propriété sur laquelle le filtrage peut être basé), utilisez la syntaxe suivante : -Filter *EMEA*.

LocalStore

Facultatif

Paramètre de commutateur

Extrait les données des paramètres de configuration de téléphonie UC du réplica local du magasin central de gestion et non du magasin central de gestion proprement dit.

Types d’entrées

Aucun. Get-CsUCPhoneConfiguration n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

Get-CsUCPhoneConfiguration renvoie les instances de l'objet Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings.

Exemple

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

Get-CsUCPhoneConfiguration

La commande illustrée dans l’exemple 1 renvoie toutes les collections de paramètres de configuration de téléphonie UC actuellement utilisés dans l’organisation. L’appel de Get-CsUCPhoneConfiguration sans aucun paramètre supplémentaire renvoie toujours une collection complète de paramètres de configuration de téléphone.

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

Get-CsUCPhoneConfiguration -Identity site:Redmond

Dans l’exemple 2, seuls les paramètres de configuration de téléphonie UC dont l’identité est site:Redmond sont renvoyés. Étant donné que les identités doivent être uniques, cette commande ne renverra jamais plus d’une collection de paramètres de configuration de téléphone.

-------------------------- Exemple 3 --------------------------

Get-CsUCPhoneConfiguration -Filter site:*

Dans la commande précédente, tous les paramètres de téléphonie UC qui ont été configurés dans l’étendue Site sont renvoyés. Pour ce faire, on appelle la cmdlet Get-CsUCPhoneConfiguration conjointement avec le paramètre Filter. La valeur de filtre « site:* » limite les données renvoyées aux paramètres dont la propriété Identity (la seule sur laquelle le filtrage peut être basé) commence par la valeur de chaîne « site: ». Par définition, tous les paramètres dont l’identité commence par la valeur de chaîne « site: » ont été configurés dans l’étendue Site.

-------------------------- Exemple 4 --------------------------

Get-CsUCPhoneConfiguration | Where-Object {$_.SIPSecurityMode -eq "Medium"}

L’exemple 4 renvoie les paramètres de configuration de téléphonie UC pour lesquels le mode de sécurité SIP est défini sur Medium (la sécurité SIP peut être définie sur Low, Medium ou High). Pour exécuter cette tâche, la commande utilise d’abord la cmdlet Get-CsUCPhoneConfiguration sans paramètre supplémentaire pour renvoyer un ensemble de tous les paramètres de téléphonie UC configurés dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui choisit uniquement les paramètres pour lesquels la propriété SIPSecurityMode est égale à Medium.

-------------------------- Exemple 5 --------------------------

Get-CsUCPhoneConfiguration | Where-Object {$_.EnforcePhoneLock -eq $False -or $_.MinPhonePinLength -lt 6}

Dans l’exemple 5, les paramètres de téléphonie UC répondant à l’un ou plusieurs des critères suivants sont renvoyés : 1) le verrouillage du téléphone n’est pas appliqué, et/ou 2) la longueur minimale du code confidentiel est inférieure à 6 chiffres. Pour ce faire, la commande appelle d’abord Get-CsUCPhoneConfiguration pour retourner une collection de tous les paramètres de téléphonie UC utilisés dans l’organisation. Cette collection est ensuite redirigée vers Where-Object qui sélectionne les éléments répondant à un (ou tous) les critères suivants : 1) la propriété EnforcePhoneLock est égale à False et/ou 2) la propriété MinPhoneLength est inférieure à 6.

L’opérateur -or indique à Where-Object que les paramètres répondant à un (ou tous) les critères doivent être sélectionnés. Pour sélectionner les paramètres répondant à tous les critères (dans ce cas, le verrouillage du téléphone n’est pas appliqué et le code confidentiel comporte moins de 6 chiffres), utilisez l’opérateur -and :

Where-Object {$_.EnforcePhoneLock -eq $False -and $_.MinPhonePinLength -lt 6}