New-App

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.

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.

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.

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.

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.

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.

Questo parametro è riservato all'uso interno da parte di Microsoft.

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).

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.

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)

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

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

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.

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.

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

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.

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

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.

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.

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.

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.