New-App
Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Puede que algunos parámetros y opciones de configuración sean exclusivos de un entorno u otro.
Use el cmdlet New-App para instalar aplicaciones para Outlook.
Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.
Syntax
New-App
[-Etoken <String>]
[-Mailbox <MailboxIdParameter>]
[-MarketplaceCorrelationID <String>]
[-MarketplaceAssetID <String>]
[-MarketplaceQueryMarket <String>]
[-MarketplaceServicesUrl <String>]
[-MarketplaceUserProfileType <String>]
[-AllowReadWriteMailbox]
[-Confirm]
[-DefaultStateForUser <DefaultStateForUser>]
[-DomainController <Fqdn>]
[-DownloadOnly]
[-Enabled <Boolean>]
[-OrganizationApp]
[-PrivateCatalog]
[-ProvidedTo <ClientExtensionProvidedTo>]
[-UserList <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]New-App
[-FileData <Byte[]>]
[-AllowReadWriteMailbox]
[-Confirm]
[-DefaultStateForUser <DefaultStateForUser>]
[-DomainController <Fqdn>]
[-DownloadOnly]
[-Enabled <Boolean>]
[-Mailbox <MailboxIdParameter>]
[-OrganizationApp]
[-PrivateCatalog]
[-ProvidedTo <ClientExtensionProvidedTo>]
[-UserList <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]New-App
[-FileStream <Stream>]
[-AllowReadWriteMailbox]
[-Confirm]
[-DefaultStateForUser <DefaultStateForUser>]
[-DomainController <Fqdn>]
[-DownloadOnly]
[-Enabled <Boolean>]
[-Mailbox <MailboxIdParameter>]
[-OrganizationApp]
[-PrivateCatalog]
[-ProvidedTo <ClientExtensionProvidedTo>]
[-UserList <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]New-App
[-Url <Uri>]
[-AllowReadWriteMailbox]
[-Confirm]
[-DefaultStateForUser <DefaultStateForUser>]
[-DomainController <Fqdn>]
[-DownloadOnly]
[-Enabled <Boolean>]
[-Mailbox <MailboxIdParameter>]
[-OrganizationApp]
[-PrivateCatalog]
[-ProvidedTo <ClientExtensionProvidedTo>]
[-UserList <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]Description
Si la aplicación está habilitada para toda la organización, los usuarios pueden activar la nueva aplicación al ver los elementos de correo o calendario dentro de Microsoft Outlook o Outlook en la Web. Si una aplicación instalada no está habilitada, los usuarios pueden habilitar la aplicación desde Outlook en la Web Opciones. De forma similar, los administradores pueden habilitar las aplicaciones instaladas desde el Centro de administración de Exchange o mediante el cmdlet Enable-App o Set-App.
Para obtener más información, vea Administrar el acceso de usuario a complementos para Outlook en Exchange Server y Administrar la implementación de complementos en el Centro de administración de Microsoft 365.
Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.
Ejemplos
Ejemplo 1
New-App -FileData ([System.IO.File]::ReadAllBytes('C:\Apps\FinanceTestApp.xml'))En este ejemplo se instala el archivo de manifiesto de la aplicación Finance Test que se ha copiado en el disco duro local.
Ejemplo 2
New-App -OrganizationApp -Url https://Server01.Contoso.com/apps/ContosoCRMApp/manifest.xml -ProvidedTo SpecificUsers -UserList "user1,user2,user3,user4,user5" -DefaultStateForUser EnabledEn este ejemplo se instala la aplicación Contoso CRM manifest.xml desde una dirección URL en la red corporativa de Contoso. El servidor de Exchange debe poder acceder a la dirección URL de destino. Esta aplicación se instala como una aplicación de organización, está disponible para una lista específica de usuarios y está habilitada para esos usuarios de forma predeterminada.
Parámetros
-AllowReadWriteMailbox
El modificador AllowReadWriteMailbox especifica si la aplicación permite el permiso de buzón de lectura y escritura. No es necesario especificar un valor con este modificador.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Confirm
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.
- Los cmdlets destructivos (por ejemplo, cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta:
-Confirm:$false. - La mayoría de los demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-DefaultStateForUser
El parámetro DefaultStateForUser especifica el estado inicial predeterminado de una aplicación de organización. Los valores admitidos son:
- Habilitado: la aplicación de la organización está habilitada de forma predeterminada.
- Deshabilitado: la aplicación de la organización está deshabilitada de forma predeterminada. Este es el valor predeterminado.
- AlwaysEnabled: la aplicación de la organización está habilitada y los usuarios no pueden deshabilitarla.
Debe usar el modificador OrganizationApp cuando use este parámetro.
| Type: | DefaultStateForUser |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
Este parámetro solo está disponible en Exchange local.
El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DownloadOnly
El modificador DownloadOnly especifica si se debe obtener el archivo de manifiesto de la aplicación y pedir confirmación al usuario antes de confirmar la instalación real. No es necesario especificar un valor con este modificador.
Cuando se usa este modificador, el cmdlet solo descarga el archivo de manifiesto de la aplicación y muestra las propiedades de la aplicación sin instalar la aplicación.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Enabled
El parámetro Enabled especifica si la aplicación está disponible para los usuarios de la organización. Los valores admitidos son:
- $true: La aplicación está disponible para los usuarios especificados. Este es el valor predeterminado.
- $false: La aplicación está oculta a todos los usuarios de la organización.
Esta configuración invalida las opciones ProvidedTo, UserList y DefaultStateForUser. Esta opción no evita que los usuarios instalen su propia instancia de la aplicación si cuentan con permiso de instalación.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Etoken
Este parámetro está reservado para uso interno de Microsoft.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-FileData
El parámetro FileData especifica la ubicación del archivo de manifiesto de la aplicación. Solo debe especificar una ubicación de origen para el archivo de manifiesto de la aplicación. Puede especificar el archivo de manifiesto de aplicación mediante el parámetro MarketplaceServicesUrl, Url o FileData.
Un valor válido para este parámetro requiere que lea el archivo en un objeto codificado en bytes mediante la sintaxis siguiente: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Puede usar este comando como valor de parámetro o puede escribir la salida en una variable ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) y usar la variable como valor del parámetro ($data).
| Type: | Byte[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-FileStream
El parámetro FileStream solo lo usa el Centro de administración de Exchange para admitir el cargador de archivos de la aplicación. No use este parámetro para especificar el archivo de manifiesto de la aplicación. Puede especificar el archivo de manifiesto de la aplicación mediante el parámetro MarketplaceServicesUrl, Url o FileData.
| Type: | Stream |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Mailbox
El parámetro Mailbox especifica el buzón donde desea instalar la aplicación. Es posible usar cualquier valor que identifique exclusivamente el buzón. Por ejemplo: por ejemplo:
- Nombre
- Alias
- Nombre distintivo (DN)
- Nombre completo (DN)
- Dominio\Nombre de usuario
- Dirección de correo electrónico
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuario o nombre de la entidad de seguridad de usuario (UPN)
| Type: | MailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-MarketplaceAssetID
El parámetro MarketplaceAssetID especifica el identificador de la Tienda Office para la aplicación. Debe usar este parámetro si usa el parámetroMarketplaceServicesUrl.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-MarketplaceCorrelationID
El parámetro MarketplaceCorrelationID especifica el identificador de correlación de la Tienda Office para la aplicación.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-MarketplaceQueryMarket
El parámetro MarketplaceQueryMarket especifica la configuración regional en la que se presenta una aplicación en office Marketplace. Por ejemplo, una aplicación para el mercado de Estados Unidos en inglés usa el valor en-US. El valor predeterminado es en-US.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-MarketplaceServicesUrl
El parámetro MarketplaceServicesUrl especifica la dirección URL de servicios completos de la aplicación. Solo debe especificar una ubicación de origen para el archivo de manifiesto de la aplicación. Puede especificar el archivo de manifiesto de la aplicación mediante el parámetro MarketplaceServicesUrl, Url o FileData.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-MarketplaceUserProfileType
El parámetro MarketplaceUserProfileType especifica el tipo de perfil de usuario para la Tienda Office.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-OrganizationApp
El modificador OrganizationApp especifica que el ámbito de aplicación es a nivel de la organización (no relativa a un usuario específico). No es necesario especificar un valor con este modificador.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-PrivateCatalog
El modificador PrivateCatalog especifica si la aplicación se encuentra en un catálogo privado. No es necesario especificar un valor con este modificador.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ProvidedTo
El parámetro ProvidedTo especifica la disponibilidad de la aplicación en la organización. Los valores admitidos son:
- Todos: este es el valor predeterminado. Esta aplicación se proporciona a todos los usuarios de la organización. Cada usuario ve esta aplicación en la lista de aplicaciones instaladas en Outlook en la Web Opciones. Cuando una aplicación de la lista de aplicaciones instaladas se habilita, los usuarios pueden usar las características de esta aplicación en su correo electrónico. Se bloquea a todos los usuarios para que no instalen su propia instancia de la aplicación, incluyendo, entre otros, los usuarios con permisos para instalar aplicaciones.
- SpecificUsers: esta aplicación se proporciona solo a los usuarios especificados por el parámetro UserList. Todos los demás usuarios no ven esta aplicación organizativa en su vista de administración, ni se activarán en sus elementos de correo o calendario. También se impide que los usuarios especificados instalen su propia instancia de esta aplicación. No se impide que los usuarios que no están en la lista instalen su propia instancia de esta aplicación.
Este parámetro se usa con el modificador OrganizationApp.
| Type: | ClientExtensionProvidedTo |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Url
El parámetro Url especifica la ubicación de dirección URL completa del archivo de manifiesto de aplicación que desea instalar. Solo debe especificar una ubicación de origen para el archivo de manifiesto de la aplicación. Puede especificar el archivo de manifiesto de la aplicación mediante el parámetro MarketplaceServicesUrl, Url o FileData.
Nota: Las direcciones URL con redireccionamiento no se admiten en Exchange Server 2016, Exchange Server 2019 y Exchange Online. Use una dirección URL directa al manifiesto.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-UserList
El parámetro UserList especifica quién puede usar una aplicación organizativa. Este parámetro está limitado a 1000 usuarios. En el servicio basado en la nube, este valor es menos relevante, ya que la administración de complementos de Office se está moviendo a Implementación centralizada.
Los valores válidos son usuarios de buzones o de correo de la organización. Puede usar cualquier valor que identifique el usuario de forma exclusiva. Por ejemplo:
- Nombre
- Alias
- Nombre distintivo (DN)
- Nombre completo (DN)
- Dominio\Nombre de usuario
- Dirección de correo electrónico
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuario o nombre de la entidad de seguridad de usuario (UPN)
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".
Este parámetro se usa con el modificador OrganizationApp.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-WhatIf
El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
Entradas
Input types
Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.
Salidas
Output types
Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.