Set-App
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.
La cmdlet Set-App permet de modifier la disponibilité des applications de l’organisation.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Set-App
[-Identity] <AppIdParameter>
[-Confirm]
[-DefaultStateForUser <DefaultStateForUser>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-OrganizationApp]
[-PrivateCatalog]
[-ProvidedTo <ClientExtensionProvidedTo>]
[-UserList <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]Descrizione
Il cmdlet Set-App può essere utilizzato solamente durante la configurazione della disponibilità di un'app dell'organizzazione. Questa attività richiede che l'app specificata sia già stata installata, ad esempio che l'app sia stata installata con il cmdlet New-App o che sia un'app predefinita per Outlook.
Le app predefinite in Outlook sul web e le app installate per l'uso da parte degli utenti dell'organizzazione sono note come app dell'organizzazione. Le app dell'organizzazione non possono essere rimosse dagli utenti finali, ma possono essere abilitate o disabilitate. Se un'app è un'app dell'organizzazione (con ambito predefinito o dell'organizzazione), il controllo di eliminazione sulla barra degli strumenti è disabilitato per gli utenti finali. Gli amministratori possono invece rimuovere le app dell'organizzazione. Gli amministratori non possono rimuovere le app predefinite, ma possono disabilitarle per l'intera organizzazione.
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
$a= Get-DistributionGroupMember -Identity "Finance Team"
Set-App -OrganizationApp -Identity 3f10017a-9bbe-4a23-834b-6a8fe3af0e37 -ProvidedTo SpecificUsers -UserList $a.Identity -DefaultStateForUser EnabledIn questo esempio viene modificato il nome dell'app dell'organizzazione FinanceTestApp, installata in precedenza per tutti gli utenti dell'organizzazione, affinché sia fornita ai membri del team finanziario e sia abilitata per impostazione predefinita.
Esempio 2
Set-App -OrganizationApp -Identity 3f10017a-9bbe-4a23-834b-6a8fe3af0e37 -Enabled $falseIn questo esempio l'app dell'organizzazione denominata FinanceTestApp viene disabilitata in tutta l'organizzazione e nascosta alla vista degli utenti finali.
Parametri
-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 dell'app dell'organizzazione per gli utenti specificati. I valori validi sono:
- Enabled: l'app dell'organizzazione è abilitata.
- Disabled: l'app dell'organizzazione è disabilitata. Questo è il valore predefinito.
- AlwaysEnabled: l'app dell'organizzazione è abilitata e gli utenti non possono disabilitarla.
È possibile utilizzare tale parametro con l'opzione OrganizationApp.
| 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 |
-Enabled
Il parametro Enabled consente di specificare se l'app è disponibile per gli utenti dell'organizzazione. I valori validi sono:
- $true: l'app è abilitata per gli utenti specificati. Questo è il valore predefinito.
- $false: l'app non è abilitata per tutti gli utenti nell'organizzazione. In questo modo, l'app non è più visibile a tutti gli utenti.
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 |
-Identity
Il parametro Identity consente di specificare il AppID (valore GUID) dell'app da modificare. Per trovare il valore GUID di un'app, eseguire il comando Get-App | Format-Table -Auto DisplayName,AppId.
| Type: | AppIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, 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 consente di specificare che l'app da modificare 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 i seguenti:
- Everyone: l'app è fornita a ogni utente nell'organizzazione. Questo è il valore predefinito. 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 |
-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". Le dimensioni massime dell'elenco sono 1000 destinatari.
È 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.