Usare i cmdlet di PowerShell della distribuzione centralizzata per gestire i componenti aggiuntivi

In qualità di amministratore globale di Microsoft 365, è possibile distribuire i componenti aggiuntivi di Office agli utenti tramite la funzionalità Distribuzione centralizzata (vedere Distribuire i componenti aggiuntivi di Office nell'interfaccia di amministrazione). Oltre a distribuire i componenti aggiuntivi di Office tramite il interfaccia di amministrazione di Microsoft 365, è anche possibile usare Microsoft PowerShell. Installare il modulo di distribuzione di Add-In centralizzato O365 per Windows PowerShell.

Dopo aver scaricato il modulo, aprire una normale finestra di Windows PowerShell ed eseguire il cmdlet seguente:

 Import-Module -Name O365CentralizedAddInDeployment

Connettersi usando le credenziali di amministratore

Prima di poter usare i cmdlet di distribuzione centralizzata, è necessario accedere.

1. Avviare PowerShell.

2. Connettersi a PowerShell usando le credenziali di amministratore aziendale. Eseguire il cmdlet seguente.

Connect-OrganizationAddInService

3. Nel prompt di accesso visualizzato selezionare o immettere le credenziali dell'utente di Microsoft 365 Amministrazione o amministratore globale.

Nota

Per altre informazioni sull'uso di PowerShell, vedere Connettersi a Microsoft 365 con PowerShell.

Caricare un manifesto del componente aggiuntivo

Eseguire il cmdlet New-OrganizationAdd-In per caricare un manifesto del componente aggiuntivo da un percorso, che può essere un percorso di file o un URL. Nell'esempio seguente viene illustrato un percorso del file per il valore del parametro ManifestPath .

New-OrganizationAddIn -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US'

È anche possibile eseguire il cmdlet New-OrganizationAdd-In per caricare un componente aggiuntivo e assegnarlo direttamente a utenti o gruppi usando il parametro Members , come illustrato nell'esempio seguente. Separare gli indirizzi di posta elettronica dei membri con una virgola.

New-OrganizationAddIn -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US' -Members  'KathyBonner@contoso.com', 'MaxHargrave@contoso.com'

Caricare un componente aggiuntivo da Office Store

Eseguire il cmdlet New-OrganizationAddIn per caricare un manifesto da Office Store.

Nell'esempio seguente il cmdlet New-OrganizationAddIn specifica l'AssetId per un componente aggiuntivo per una posizione Stati Uniti e un mercato del contenuto.

New-OrganizationAddIn -AssetId 'WA104099688' -Locale 'en-US' -ContentMarket 'en-US'

Per determinare il valore per il parametro AssetId , è possibile copiarlo dall'URL della pagina Web di Office Store per il componente aggiuntivo. Gli AssetId iniziano sempre con "WA" seguito da un numero. Nell'esempio precedente, ad esempio, l'origine del valore AssetId di WA104099688 è l'URL della pagina Web di Office Store per il componente aggiuntivo: https://store.office.com/en-001/app.aspx?assetid=WA104099688.

I valori per il parametro Locale e il parametro ContentMarket sono identici e indicano il paese o l'area geografica da cui si sta tentando di installare il componente aggiuntivo. Il formato è en-US, fr-FR e così via.

Nota

I componenti aggiuntivi caricati da Office Store verranno aggiornati automaticamente entro pochi giorni dall'ultimo aggiornamento disponibile in Office Store.

Ottenere i dettagli di un componente aggiuntivo

Eseguire il cmdlet Get-OrganizationAddIn come illustrato di seguito per ottenere i dettagli di tutti i componenti aggiuntivi caricati nel tenant, incluso l'ID prodotto di un componente aggiuntivo.

Get-OrganizationAddIn

Eseguire il cmdlet Get-OrganizationAddIn con un valore per il parametro ProductId per specificare il componente aggiuntivo per cui recuperare i dettagli.

Get-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122

Per ottenere i dettagli completi di tutti i componenti aggiuntivi più gli utenti e i gruppi assegnati, inviare tramite pipe l'output del cmdlet Get-OrganizationAddIn al cmdlet Format-List, come illustrato nell'esempio seguente.

foreach($G in (Get-organizationAddIn)){Get-OrganizationAddIn -ProductId $G.ProductId | Format-List}

Attivare o disattivare un componente aggiuntivo

Per disattivare un componente aggiuntivo in modo che gli utenti e i gruppi assegnati non abbiano più accesso, eseguire il cmdlet Set-OrganizationAddIn con il parametro ProductId e il parametro Enabled impostato su $false, come illustrato nell'esempio seguente.

Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Enabled $false

Per riattivare un componente aggiuntivo, eseguire lo stesso cmdlet con il parametro Enabled impostato su $true.

Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Enabled $true

Aggiungere o rimuovere utenti da un componente aggiuntivo

Per aggiungere utenti e gruppi a un componente aggiuntivo specifico, eseguire il cmdlet Set-OrganizationAddInAssignments con i parametri ProductId, Add e Members . Separare gli indirizzi di posta elettronica dei membri con una virgola.

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Add -Members 'KathyBonner@contoso.com','sales@contoso.com'

Per rimuovere utenti e gruppi, eseguire lo stesso cmdlet usando il parametro Remove .

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Remove -Members 'KathyBonner@contoso.com','sales@contoso.com'

Per assegnare un componente aggiuntivo a tutti gli utenti nel tenant, eseguire lo stesso cmdlet usando il parametro AssignToEveryone con il valore impostato su $true.

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -AssignToEveryone $true

Per non assegnare un componente aggiuntivo a tutti e ripristinare gli utenti e i gruppi assegnati in precedenza, è possibile eseguire lo stesso cmdlet e disattivare il parametro AssignToEveryone impostandone il valore su $false.

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -AssignToEveryone $false

Aggiornare un componente aggiuntivo

Per aggiornare un componente aggiuntivo da un manifesto, eseguire il cmdlet Set-OrganizationAddIn con i parametri ProductId, ManifestPath e Locale , come illustrato nell'esempio seguente.

Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US'

Nota

I componenti aggiuntivi caricati da Office Store verranno aggiornati automaticamente entro pochi giorni dall'ultimo aggiornamento disponibile in Office Store.

Eliminare un componente aggiuntivo

Per eliminare un componente aggiuntivo, eseguire il cmdlet Remove-OrganizationAddIn con il parametro ProductId , come illustrato nell'esempio seguente.

Remove-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122

Ottenere informazioni dettagliate per ogni cmdlet

È possibile esaminare la Guida dettagliata per ogni cmdlet usando il cmdlet Get-help. Ad esempio, il cmdlet seguente fornisce informazioni dettagliate sul cmdlet Remove-OrganizationAddIn.

Get-help Remove-OrganizationAddIn -Full