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

Gli amministratori di Office 365 possono distribuire i componenti aggiuntivi per Office agli utenti usando la caratteristica di distribuzione centralizzata. Vedere Distribuire i componenti aggiuntivi per Office nell'interfaccia di amministrazione di Office 365. I componenti aggiuntivi per Office possono essere distribuiti con l'Interfaccia di amministrazione di Office 365 o con Microsoft PowerShell. Scaricare i cmdlet di PowerShell della distribuzione centralizzata da Area download Microsoft.

Per saperne di più

Connettersi con le credenziali di amministratore

Caricare un manifesto del componente aggiuntivo

Caricare un componente aggiuntivo da Office Store

Ottenere informazioni dettagliate su un componente aggiuntivo

Attivare o disattivare un componente aggiuntivo

Aggiungere o rimuovere utenti da un componente aggiuntivo

Aggiornare un componente aggiuntivo

Eliminare un componente aggiuntivo

Ottenere informazioni dettagliate su ogni cmdlet

Connettersi con le credenziali di amministratore

Prima di usare i cmdlet della distribuzione centralizzata, è necessario effettuare l'accesso.

  1. Avviare PowerShell.

  2. Connettersi a PowerShell usando le credenziali di amministratore della società, quindi eseguire questo cmdlet.

    Connect-OrganizationAddInService
  3. Nella pagina Immettere le credenziali inserire le credenziali di amministratore globale di Office 365. In alternativa, è possibile immettere le credenziali direttamente nel cmdlet.

    Eseguire il cmdlet seguente specificando le credenziali di amministratore della società come oggetto PSCredential.

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

Nota : Per altre informazioni sull'uso di PowerShell, vedere Connettersi a PowerShell di Office 365.

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 del file o un URL. L'esempio seguente mostra un percorso di 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 a utenti o gruppi direttamente con il parametro Members, come mostrato 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 AssetId di un componente aggiuntivo per un mercato con contenuti e posizione negli Stati Uniti.

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

Per determinare il valore del parametro AssetId, è possibile copiarlo dall'URL della pagina Web Office Store per il componente aggiuntivo. AssetId inizia sempre con "WA" seguito da un numero. Ad esempio, nell'esempio precedente 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 uguali e indicano il paese/area geografica da cui si prova l'installazione del componente aggiuntivo. Il formato è en-US, fr-FR e così via.

Nota : I componenti aggiuntivi caricati da Office Store verranno aggiornati automaticamente pochi giorni dopo l'aggiornamento più recente disponibile in Office Store.

Ottenere informazioni dettagliate su un componente aggiuntivo

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

Get-OrganizationAddIn

Eseguire il cmdlet Get-OrganizationAddIn con un valore per il parametro ProductId per specificare di quale componente aggiuntivo si vogliono recuperare i dettagli.

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

Per i dettagli di tutti i componenti aggiuntivi e sugli utenti e gruppi assegnati, eseguire il piping dell'output del cmdlet Get-OrganizationAddIn al cmdlet Format-List, come mostrato nell'esempio seguente.

Get-OrganizationAddIn |Format-List

Attivare o disattivare un componente aggiuntivo

Per disattivare un componente aggiuntivo in modo che gli utenti e i gruppi assegnati ad esso non possano più accedervi, eseguire il cmdlet Set-OrganizationAddIn con il parametro ProductId e il parametro Enabled impostato su $false, come mostrato 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 con 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 gli utenti 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 pochi giorni dopo l'aggiornamento più recente 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 su ogni cmdlet

È possibile esaminare le informazioni dettagliate 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
Amplia le tue competenze
Esplora i corsi di formazione
Ottieni in anticipo le nuove caratteristiche
Partecipa al programma Office Insider

Queste informazioni sono risultate utili?

Grazie per i tuoi commenti e suggerimenti

Grazie per il tuo feedback! Potrebbe essere utile metterti in contatto con uno dei nostri operatori del supporto di Office.

×