Usare i cmdlet di PowerShell della distribuzione centralizzata per gestire i componenti aggiuntiviUse the Centralized Deployment PowerShell cmdlets to manage add-ins

In qualità di amministratore globale di Microsoft 365, è possibile distribuire i componenti aggiuntivi di Office agli utenti tramite la caratteristica di distribuzione centralizzata (vedere Deploy Office Add-ins in the Admin Center).As a Microsoft 365 global admin, you can deploy Office add-ins to users via the Centralized Deployment feature (see Deploy Office Add-ins in the admin center). Oltre a distribuire i componenti aggiuntivi di Office tramite l'interfaccia di amministrazione di Microsoft 365, è anche possibile utilizzare Microsoft PowerShell.In addition to deploying Office add-ins via the Microsoft 365 admin center, you can also use Microsoft PowerShell. Installare il modulo di distribuzione del componente aggiuntivo centralizzato di O365 per Windows PowerShell.Install the O365 Centralized Add-In Deployment Module for Windows PowerShell.

Dopo aver scaricato il modulo, aprire una normale finestra di Windows PowerShell ed eseguire il cmdlet seguente:After you download the module, open a regular Windows PowerShell window and run the following cmdlet:

 Import-Module -Name O365CentralizedAddInDeployment

Connettersi utilizzando le credenziali di amministratoreConnect using your admin credentials

Prima di poter utilizzare i cmdlet di distribuzione centralizzata, è necessario eseguire l'accesso.Before you can use the Centralized Deployment cmdlets, you need to sign in.

  1. Avviare PowerShell.Start PowerShell.

  2. Connettersi a PowerShell mediante le credenziali di amministratore della società.Connect to PowerShell by using your company admin credentials. Eseguire il cmdlet seguente.Run the following cmdlet.

Connect-OrganizationAddInService
  1. Nella pagina Enter credentials immettere le credenziali di amministratore globale di Microsoft 365.In the Enter Credentials page, enter your Microsoft 365 global admin credentials. In alternativa, è possibile immettere le credenziali direttamente nel cmdlet.Alternately, you can enter your credentials directly into the cmdlet.

    Eseguire il cmdlet seguente specificando le credenziali di amministratore dell'azienda come oggetto PSCredential.Run the following cmdlet specifying your company admin credentials as a PSCredential object.

$secpasswd = ConvertTo-SecureString "MyPassword" -AsPlainText -Force
$mycredentials = New-Object System.Management.Automation.PSCredential ("serviceaccount@contoso.com", $secpasswd)
Connect-OrganizationAddInService -Credential $mycredentials

Nota

Per ulteriori informazioni sull'utilizzo di PowerShell, vedere Connect to Microsoft 365 with PowerShell.For more information about using PowerShell, see Connect to Microsoft 365 with PowerShell.

Caricare un manifesto del componente aggiuntivoUpload an add-in manifest

Eseguire il cmdlet New-organizzazionecomponenti-in per caricare un manifesto del componente aggiuntivo da un percorso, che può essere un percorso o un URL di file.Run the New-OrganizationAdd-In cmdlet to upload an add-in manifest from a path, which can be either a file location or URL. Nell'esempio seguente viene illustrato un percorso di file per il valore del parametro ManifestPath .The following example shows a file location for the value of the ManifestPath parameter.

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

È inoltre possibile eseguire il cmdlet New-organizzazionecomponenti-in per caricare un componente aggiuntivo e assegnarlo direttamente agli utenti o ai gruppi tramite il parametro Members , come illustrato nell'esempio seguente.You can also run the New-OrganizationAdd-In cmdlet to upload an add-in and assign it to users or groups directly by using the Members parameter, as shown in the following example. Separare gli indirizzi di posta elettronica dei membri con una virgola.Separate the email addresses of members with a comma.

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 StoreUpload an add-in from the Office Store

Eseguire il cmdlet New-OrganizationAddIn per caricare un manifesto da Office Store.Run the New-OrganizationAddIn cmdlet to upload a manifest from the Office Store.

Nell'esempio seguente, il cmdlet New-OrganizationAddIn consente di specificare il AssetID per un componente aggiuntivo per un sito e un mercato del contenuto degli Stati Uniti.In the following example, the New-OrganizationAddIn cmdlet specifies the AssetId for an add-in for a United States location and content market.

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.To determine the value for the AssetId parameter, you can copy it from the URL of the Office Store webpage for the add-in. AssetIds inizia sempre con "WA" seguito da un numero.AssetIds always begin with "WA" followed by a number. Nell'esempio precedente, ad esempio, l'origine per il 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 .For example, in the previous example, the source for the AssetId value of WA104099688 is the Office Store webpage URL for the add-in: https://store.office.com/en-001/app.aspx?assetid=WA104099688.

I valori per il parametro locale e per il parametro ContentMarket sono identici e indicano il paese o l'area geografica in cui si sta tentando di installare il componente aggiuntivo.The values for the Locale parameter and the ContentMarket parameter are identical and indicate the country/region you're trying to install the add-in from. Il formato è en-US, fr-FR.The format is en-US, fr-FR. e così via.and so forth.

Nota

I componenti aggiuntivi caricati da Office Store vengono aggiornati automaticamente entro pochi giorni dall'ultimo aggiornamento disponibile in Office Store.Add-ins uploaded from the Office Store will update automatically within a few days of the latest update being available on the Office Store.

Ottenere informazioni dettagliate su un componente aggiuntivoGet details of an add-in

Eseguire il cmdlet Get-OrganizationAddIn come illustrato di seguito per ottenere informazioni dettagliate su tutti i componenti aggiuntivi caricati nel tenant, incluso un ID prodotto del componente aggiuntivo.Run the Get-OrganizationAddIn cmdlet as shown below to get details of all add-ins uploaded to the tenant, included an add-in's product ID.

Get-OrganizationAddIn

Eseguire il cmdlet Get-OrganizationAddIn con un valore per il parametro ProductID per specificare il componente aggiuntivo di cui si desidera recuperare i dettagli.Run the Get-OrganizationAddIn cmdlet with a value for the ProductId parameter to specify which add-in you want to retrieve details for.

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

Per ottenere informazioni complete su tutti i componenti aggiuntivi più gli utenti e i gruppi assegnati, eseguire il piping dell'output del cmdlet Get-OrganizationAddIn al cmdlet Format-List, come illustrato nell'esempio seguente.To get full details of all the add-ins plus the assigned users and groups, pipe the output of the Get-OrganizationAddIn cmdlet to the Format-List cmdlet, as shown in the following example.

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

Attivazione o disattivazione di un componente aggiuntivoTurn on or turn off an add-in

Per disattivare un componente aggiuntivo in modo che gli utenti e i gruppi a esso assegnati non avranno più accesso, eseguire il cmdlet set-OrganizationAddIn con il parametro ProductID e il parametro Enabled impostato su $false , come illustrato nell'esempio seguente.To turn off an add-in so users and groups that are assigned to it will no longer have access, run the Set-OrganizationAddIn cmdlet with the ProductId parameter and the Enabled parameter set to $false, as shown in the following example.

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

Per attivare di nuovo un componente aggiuntivo, eseguire lo stesso cmdlet con il parametro Enabled impostato su $true .To turn an add-in back on, run the same cmdlet with the Enabled parameter set to $true.

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

Aggiungere o rimuovere utenti da un componente aggiuntivoAdd or remove users from an add-in

Per aggiungere utenti e gruppi a un componente aggiuntivo specifico, eseguire il cmdlet set-OrganizationAddInAssignments con i parametri ProductID, _Add_e Members .To add users and groups to a specific add-in, run the Set-OrganizationAddInAssignments cmdlet with the ProductId, Add, and Members parameters. Separare gli indirizzi di posta elettronica dei membri con una virgola.Separate the email addresses of members with a comma.

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 utilizzando il parametro Remove .To remove users and groups, run the same cmdlet using the Remove parameter.

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 utilizzando il parametro AssignToEveryone con il valore impostato su $true .To assign an add-in to all users on the tenant, run the same cmdlet using the AssignToEveryone parameter with the value set to $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 precedentemente assegnati, è possibile eseguire lo stesso cmdlet e disattivare il parametro AssignToEveryone impostando il relativo valore su $false .To not assign an add-in to everyone and revert to the previously assigned users and groups, you can run the same cmdlet and turn off the AssignToEveryone parameter by setting its value to $false.

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

Aggiornare un componente aggiuntivoUpdate an add-in

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.To update an add-in from a manifest, run the Set-OrganizationAddIn cmdlet with the ProductId, ManifestPath, and Locale parameters, as shown in the following example.

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 vengono aggiornati automaticamente entro pochi giorni dall'ultimo aggiornamento disponibile in Office Store.Add-ins uploaded from the Office Store will update automatically within a few days of the latest update being available on the Office Store.

Eliminare un componente aggiuntivoDelete an add-in

Per eliminare un componente aggiuntivo, eseguire il cmdlet Remove-OrganizationAddIn con il parametro ProductID , come illustrato nell'esempio seguente.To delete an add-in, run the Remove-OrganizationAddIn cmdlet with the ProductId parameter, as shown in the following example.

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

Ottenere informazioni dettagliate su ogni cmdletGet detailed help for each cmdlet

È possibile esaminare la guida dettagliata per ogni cmdlet utilizzando il cmdlet Get-Help.You can look at detailed help for each cmdlet by using the Get-help cmdlet. Ad esempio, il cmdlet seguente fornisce informazioni dettagliate sul cmdlet Remove-OrganizationAddIn.For example, the following cmdlet provides detailed information about the Remove-OrganizationAddIn cmdlet.

Get-help Remove-OrganizationAddIn -Full