New-App

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2017-03-27

Cette cmdlet est disponible dans Exchange Server 2016 sur site et dans le service en nuage. Certains paramètres peuvent être propres à un environnement ou à un autre.

Utilisez la cmdlet New-App pour installer applications pour Outlook.

Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir SyntaxeSyntaxe de cmdlet Exchange.

New-App [-FileData <Byte[]>] <COMMON PARAMETERS>

New-App [-Etoken <String>] [-MarketplaceAssetID <String>] [-MarketplaceCorrelationID <String>] [-MarketplaceQueryMarket <String>] [-MarketplaceServicesUrl <String>] [-MarketplaceUserProfileType <String>] <COMMON PARAMETERS>

New-App [-FileStream <Stream>] <COMMON PARAMETERS>

New-App [-Url <Uri>] <COMMON PARAMETERS>

COMMON PARAMETERS: [-AllowReadWriteMailbox <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DefaultStateForUser <Enabled | Disabled | AlwaysEnabled>] [-DomainController <Fqdn>] [-DownloadOnly <SwitchParameter>] [-Enabled <$true | $false>] [-Mailbox <MailboxIdParameter>] [-OrganizationApp <SwitchParameter>] [-PrivateCatalog <SwitchParameter>] [-ProvidedTo <Everyone | SpecificUsers>] [-UserList <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]

Cet exemple décrit l'installation du fichier manifeste de l'application Finance Test qui a été copié sur un disque local.

New-App -FileData ([Byte[]](Get-Content -Encoding Byte -Path "C:\Apps\FinanceTestApp.xml" -ReadCount 0))

Pour plus d'informations, consultez la rubrique Installation ou suppression d’applications pour votre organisation.

Cet exemple installe le fichier manifest.xml de l'application Contoso CRM sur le réseau d'entreprise via une URL. Le serveur Exchange doit pouvoir de se connecter à l'URL cible. Cette application est installée sous la forme d’une application d’organisation. Seuls certains utilisateurs y ont accès (accès par défaut).

New-App -OrganizationApp -Url https://Server01.Contoso.com/apps/ContosoCRMApp/manifest.xml -ProvidedTo SpecificUsers -UserList "user1,user2,user3,user4,user5" -DefaultStateForUser Enabled

Pour plus d'informations, consultez la rubrique Installation ou suppression d’applications pour votre organisation.

Si l’application est activée dans l’ensemble de l’organisation, les utilisateurs peuvent l’utiliser quand ils consultent leur messagerie ou leur calendrier dans MicrosoftOutlook ou Outlook sur le web. Si une application installée n’est pas activée, les utilisateurs peuvent l’activer via les options Outlook sur le web. De même, les administrateurs peuvent activer des applications installées à partir du Centre d’administration Exchange ou à l’aide de la cmdlet Enable-App ou Set-App.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour voir les autorisations qui vous sont nécessaires, voir entrée « applications pour Outlook » dans la rubrique Autorisations des destinataires.

 

Paramètre Obligatoire Type Description

AllowReadWriteMailbox

Facultatif

System.Management.Automation.SwitchParameter

PARAMVALUE : SwitchParameter

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Confirm spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.

DefaultStateForUser

Facultatif

Microsoft.Exchange.Management.Extension.DefaultStateForUser

Le paramètre DefaultStateForUser spécifie l’état initial par défaut d’une application de l’organisation. Les valeurs valides sont :

  • Enabled L’application de l’organisation est activée par défaut.

  • Disabled L’application de l’organisation est désactivée par défaut. Il s’agit de la valeur par défaut.

  • AlwaysEnabled    L’application de l’organisation est activée et les utilisateurs ne peuvent pas la désactiver.

Vous devez utiliser le commutateur OrganizationApp lorsque vous utilisez ce paramètre.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : dc01.contoso.com.

DownloadOnly

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur DownloadOnly indique si vous devez obtenir le fichier manifeste et demander à l'utilisateur de confirmer l'installation. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Lorsque vous utilisez ce commutateur, la cmdlet télécharge uniquement le fichier manifeste de l’application et affiche les propriétés de l’application sans l’installer.

Enabled

Facultatif

System.Boolean

Le paramètre Enabled spécifie si l’application est disponible pour les utilisateurs de l’organisation. Les valeurs valides sont :

  • $true   L’application est disponible pour les utilisateurs spécifiés. Il s’agit de la valeur par défaut.

  • $false   L’application est masquée pour tous les utilisateurs dans l’organisation.

CautionAttention :
Ce paramètre remplace les paramètres ProvidedTo, UserList et DefaultStateForUser. Ce paramètre n’empêche pas les utilisateurs d’installer leur propre instance de l’application s’ils disposent des autorisations d’installation.

Etoken

Facultatif

System.String

Ce paramètre est réservé à l’usage interne chez Microsoft.

FileData

Facultatif

System.Byte[]

Le paramètre FileData indique l'emplacement du fichier manifeste de l'application. Vous ne devez désigner qu’un seul emplacement source pour le fichier manifeste d’application. Vous pouvez désigner le fichier manifeste de l'application avec le paramètre MarketplaceServicesUrl, Url ou FileData.

Une valeur valide pour ce paramètre requiert que vous lisiez le fichier dans un objet codé en octets à l’aide de la cmdlet Get-Content. Par exemple, ([Byte[]](Get-Content -Encoding Byte -Path "C:\My Documents\<filename>" -ReadCount 0)).

FileStream

Facultatif

System.IO.Stream

Le paramètre FileStream est utilisé uniquement par le Centre d’administration Exchange pour prendre en charge l’outil de téléchargement du fichier d’application. N’utilisez ce paramètre que pour spécifier le fichier manifeste d’application. Vous pouvez désigner le fichier manifeste de l’application avec le paramètre MarketplaceServicesUrl, Url ou FileData.

Mailbox

Facultatif

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Le paramètre Mailbox spécifie la boîte aux lettres dans laquelle vous souhaitez installer l’application. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la boîte aux lettres. Par exemple :

Par exemple :

  • Nom

  • Nom complet

  • Alias

  • Nom unique

  • Nom unique canonique

  • <domain name>\<account name>

  • Adresse de messagerie

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • Identifiant utilisateur ou nom d’utilisateur principal (UPN)

MarketplaceAssetID

Facultatif

System.String

Le paramètre MarketplaceAssetID spécifie l'identificateur Office Store de l'application. Vous pouvez uniquement recourir à ce paramètre si vous utilisez le paramètre MarketplaceServicesUrl.

MarketplaceCorrelationID

Facultatif

System.String

PARAMVALUE : String

MarketplaceQueryMarket

Facultatif

System.String

Le paramètre MarketplaceQueryMarket indique les paramètres régionaux d'une application dans Office Marketplace. Par exemple, une application prévue pour les États-Unis (anglais) utilise la valeur en-US. La valeur par défaut est en-US.

MarketplaceServicesUrl

Facultatif

System.String

Le paramètre MarketplaceServicesUrl indique l'URL des services complets de l'application. Vous ne devez désigner qu’un seul emplacement source pour le fichier manifeste d’application. Vous pouvez désigner le fichier manifeste de l’application avec le paramètre MarketplaceServicesUrl, Url ou FileData.

MarketplaceUserProfileType

Facultatif

System.String

PARAMVALUE : String

OrganizationApp

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur OrganizationApp indique que la portée de l’application est celle de l’organisation (non liée à un utilisateur spécifique). Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

PrivateCatalog

Facultatif

System.Management.Automation.SwitchParameter

PARAMVALUE : SwitchParameter

ProvidedTo

Facultatif

Microsoft.Exchange.Data.ApplicationLogic.Extension.ClientExtensionProvidedTo

Le paramètre ProvidedTo spécifie la disponibilité de l’application dans votre organisation. Les valeurs valides sont :

  • Everyone   Il s’agit de la valeur par défaut. Cette application est fournie pour chaque utilisateur de l’organisation.

    Chaque utilisateur voit cette application dans la liste des applications installées dans les options Outlook sur le web. Lorsqu’une application de la liste des applications installées est activée, les utilisateurs peuvent en utiliser les fonctionnalités dans leur messagerie. L’installation de leurs propres instances de cette application est bloquée pour tous les utilisateurs, y compris, mais sans s’y limiter, les utilisateurs disposant d’autorisations d’installation d’applications.

  • SpecificUsers   Cette application n’est fournie qu’aux utilisateurs spécifiés par le paramètre UserList. Tous les autres utilisateurs ne voient pas cette application organisationnelle dans leur vue de gestion. Ils ne peuvent pas non plus l’activer dans leur messagerie ou leur calendrier. Les utilisateurs spécifiés ne peuvent pas non plus installer leur propre instance de cette application. Les utilisateurs non répertoriés peuvent installer leur propre instance de cette application.

Vous utilisez ce paramètre avec le commutateur OrganizationApp.

Url

Facultatif

System.Uri

Le paramètre Url indique l’emplacement URL complet du fichier manifeste d’application à installer. Vous ne devez désigner qu’un seul emplacement source pour le fichier manifeste d’application. Vous pouvez désigner le fichier manifeste de l’application avec le paramètre MarketplaceServicesUrl, Url ou FileData.

UserList

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre UserList spécifie qui peut utiliser une application organisationnelle. Les valeurs valides sont des boîtes aux lettres ou des utilisateurs de messagerie de votre organisation. Vous pouvez utiliser n’importe quelle valeur qui identifie l’utilisateur de façon unique.

Par exemple :

  • Nom

  • Nom complet

  • Alias

  • Nom unique

  • Nom unique canonique

  • <domain name>\<account name>

  • Adresse de messagerie

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • Identifiant utilisateur ou nom d’utilisateur principal (UPN)

Pour saisir plusieurs valeurs, utilisez la syntaxe suivante : <value1>,<value2>,...<valueX>. Si les valeurs contiennent des espaces ou requièrent des guillemets, vous devez utiliser la syntaxe suivante : "<value1>","<value2>",..."<valueX>".

Vous utilisez ce paramètre avec le commutateur OrganizationApp.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Pour visualiser les types d’entrées acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type d’entrée pour une cmdlet est vide, la cmdlet n’accepte pas les données d’entrée.

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.

 
Afficher: