Condividi tramite


New-App

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.

Usare il cmdlet New-App per installare le app per Outlook.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

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>]

Descrizione

Se l'app è abilitata per l'intera organizzazione, gli utenti possono attivare la nuova app quando visualizzano posta elettronica o elementi del calendario all'interno di Microsoft Outlook o Outlook sul web. Se un'app installata non è abilitata, gli utenti possono abilitare l'app da opzioni Outlook sul web. Analogamente, gli amministratori possono abilitare le app installate dall'interfaccia di amministrazione di Exchange o usando il cmdlet Enable-App o Set-App.

Per altre informazioni, vedere Gestire l'accesso degli utenti ai componenti aggiuntivi per Outlook in Exchange Server e Gestire la distribuzione dei componenti aggiuntivi nel interfaccia di amministrazione di Microsoft 365.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

New-App -FileData ([System.IO.File]::ReadAllBytes('C:\Apps\FinanceTestApp.xml'))

In questo esempio viene installato il file manifesto dell'app Finance Test copiato su un disco rigido locale.

Esempio 2

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

In questo esempio viene installato il file manifest.xml per l'app Contoso CRM da un URL sulla rete aziendale Contoso. Il server Exchange deve essere in grado di raggiungere l'URL di destinazione. Questa app viene installata come app dell'organizzazione e resa disponibile per uno specifico gruppo di utenti, per i quali è abilitata per impostazione predefinita.

Parametri

-AllowReadWriteMailbox

L'opzione AllowReadWriteMailbox specifica se l'app consente l'autorizzazione per la cassetta postale di lettura/scrittura. Con questa opzione non è necessario specificare alcun valore.

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

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
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

Il parametro DefaultStateForUser consente di specificare lo stato iniziale predefinito di un'app dell'organizzazione. I valori validi sono:

  • Abilitato: l'app dell'organizzazione è abilitata per impostazione predefinita.
  • Disabilitata: l'app dell'organizzazione è disabilitata per impostazione predefinita. Questo è il valore predefinito.
  • AlwaysEnabled: l'app dell'organizzazione è abilitata e gli utenti non possono disabilitarla.

È necessario utilizzare l'opzione OrganizationApp quando si utilizza questo parametro.

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

Questo parametro è disponibile solo in Exchange locale.

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, 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

L'opzione DownloadOnly consente di specificare se ottenere il file manifesto dell'app e chiedere la conferma dell'utente prima di eseguire l'installazione. Con questa opzione non è necessario specificare alcun valore.

Quando si utilizza questa opzione, il cmdlet scarica solamente il file manifesto dell'app e visualizza le proprietà dell'app senza installare l'app.

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

Il parametro Enabled consente di specificare se l'app è disponibile per gli utenti dell'organizzazione. I valori validi sono:

  • $true: l'app è disponibile per gli utenti specificati. Questo è il valore predefinito.
  • $false: l'app è nascosta a tutti gli utenti dell'organizzazione.

Questa impostazione sostituisce le impostazioni ProvidedTo, UserList e DefaultStateForUser. L'impostazione non impedisce agli utenti di installare istanze personali dell'app, qualora essi dispongano delle autorizzazioni di installazione.

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

Questo parametro è riservato all'uso interno da parte di 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

Il parametro FileData consente di specificare il percorso del file manifesto dell'app. È necessario specificare un solo percorso di origine per il file manifesto dell'app. È possibile specificare il file manifesto dell'app utilizzando il parametro MarketplaceServicesUrl, Url o FileData.

Per un valore valido per questo parametro è necessario leggere il file in un oggetto con codifica byte usando la sintassi seguente: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). È possibile usare questo comando come valore del parametro oppure scrivere l'output in una variabile ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) e usare la variabile come valore del parametro ($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

Il parametro FileStream viene usato solo dall'interfaccia di amministrazione di Exchange per supportare il caricamento di file dell'app. Non utilizzare questo parametro per specificare il file manifesto dell'app. È possibile specificare il file manifesto dell'app usando il parametro 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

Il parametro Mailbox consente di specificare la cassetta postale in cui si vuole installare l'app. È possibile utilizzare qualsiasi valore che identifichi la cassetta postale in modo univoco. Ad esempio: Ad esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Dominio\nomeutente
  • Indirizzo di posta elettronica
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID utente o Nome entità utente (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

Il parametro MarketplaceAssetID specifica l'identificatore di Office Store per l'app. È necessario utilizzare questo parametro se si usa il parametro MarketplaceServicesUrl.

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

Il parametro MarketplaceCorrelationID specifica l'identificatore di correlazione di Office Store per l'app.

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

Il parametro MarketplaceQueryMarket consente di specificare la lingua con la quale l'app è registrata in office marketplace. Ad esempio, un'app per il mercato statunitense in inglese utilizza il valore en-US. Il valore predefinito è 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

Il parametro MarketplaceServicesUrl consente di specificare l'URL dei servizi completi per l'app. È necessario specificare un solo percorso di origine per il file manifesto dell'app. È possibile specificare il file manifesto dell'app usando il parametro 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

Il parametro MarketplaceUserProfileType specifica il tipo di profilo utente per Office Store.

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

L'opzione OrganizationApp consente di specificare che l'ambito dell'app è aziendale (non correlato a un utente specifico). Con questa opzione non è necessario specificare alcun valore.

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

L'opzione PrivateCatalog specifica se l'app si trova in un catalogo privato. Con questa opzione non è necessario specificare alcun valore.

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

Il parametro ProvidedTo consente di specificare la disponibilità dell'app nell'organizzazione. I valori validi sono:

  • Tutti: questo è il valore predefinito. Questa app è fornita a ogni utente nell'organizzazione. Ogni utente visualizza questa app nell'elenco delle app installate in Opzioni Outlook sul web. Quando un'app nell'elenco delle app installate è abilitata, gli utenti possono utilizzarne le funzionalità nella posta elettronica. L'installazione di istanze personali dell'app è bloccata per tutti gli utenti, compresi quelli con autorizzazioni di installazione delle app.
  • SpecificUsers: l'app è fornita esclusivamente agli utenti specificati dal parametro UserList. Tutti gli altri utenti non visualizzano l'app dell'organizzazione nella vista di gestione e non possono attivarla negli elementi della posta elettronica o del calendario. Gli utenti specificati non possono nemmeno installare istanze personali dell'app. Gli utenti esclusi dall'elenco non vengono bloccati dall'installazione delle istanze personali dell'app.

È possibile utilizzare tale parametro con l'opzione 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

Il parametro Url consente di specificare l'URL completo del file manifesto dell'app da installare. È necessario specificare un solo percorso di origine per il file manifesto dell'app. È possibile specificare il file manifesto dell'app usando il parametro MarketplaceServicesUrl, Url o FileData.

Nota: gli URL con reindirizzamenti non sono supportati in Exchange Server 2016, Exchange Server 2019 e Exchange Online. Usare un URL diretto per il manifesto.

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

Il parametro UserList consente di specificare chi può usare un'app aziendale. Questo parametro è limitato a 1000 utenti. Nel servizio basato sul cloud questo valore è meno rilevante perché la gestione dei componenti aggiuntivi di Office passa alla distribuzione centralizzata.

I valori validi sono cassette postali o utenti di posta elettronica dell'organizzazione. È possibile utilizzare qualsiasi valore che identifichi l'utente in modo univoco. Ad esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Dominio\nomeutente
  • Indirizzo di posta elettronica
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID utente o Nome entità utente (UPN)

È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".

È possibile utilizzare tale parametro con l'opzione 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

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

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

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.