Usar los cmdlets de PowerShell de Implementación centralizada para administrar complementos

Como administrador global de Microsoft 365, puede implementar complementos de Office en los usuarios a través de la característica Implementación centralizada (consulte Implementación de complementos de Office en el Centro de administración). Además de implementar complementos de Office a través de la Centro de administración de Microsoft 365, también puede usar Microsoft PowerShell. Instale el módulo de implementación de Add-In centralizado de O365 para Windows PowerShell.

Después de descargar el módulo, abra una ventana de Windows PowerShell normal y ejecute el siguiente cmdlet:

 Import-Module -Name O365CentralizedAddInDeployment

Conexión con sus credenciales de administrador

Para poder usar los cmdlets de implementación centralizada, debe iniciar sesión.

1. Inicie PowerShell.

2. Conéctese a PowerShell con las credenciales de administrador de la empresa. Ejecute el siguiente cmdlet.

Connect-OrganizationAddInService

3. En el símbolo del sistema de inicio de sesión que se abre, seleccione o escriba las credenciales de administrador global o Administración de usuario de Microsoft 365.

Nota:

Para obtener más información sobre el uso de PowerShell, consulte Conexión a Microsoft 365 con PowerShell.

Carga de un manifiesto de complemento

Ejecute el cmdlet New-OrganizationAdd-In para cargar un manifiesto de complemento desde una ruta de acceso, que puede ser una dirección URL o una ubicación de archivo. En el ejemplo siguiente se muestra una ubicación de archivo para el valor del parámetro ManifestPath .

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

También puede ejecutar el cmdlet New-OrganizationAdd-In para cargar un complemento y asignarlo a usuarios o grupos directamente mediante el parámetro Members , como se muestra en el ejemplo siguiente. Separe las direcciones de correo electrónico de los miembros con una coma.

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

Carga de un complemento desde la Tienda Office

Ejecute el cmdlet New-OrganizationAddIn para cargar un manifiesto desde la Tienda Office.

En el ejemplo siguiente, el cmdlet New-OrganizationAddIn especifica el AssetId de un complemento para una ubicación Estados Unidos y el mercado de contenido.

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

Para determinar el valor del parámetro AssetId , puede copiarlo desde la dirección URL de la página web de la Tienda Office para el complemento. AssetIds siempre comienza por "WA" seguido de un número. Por ejemplo, en el ejemplo anterior, el origen del valor AssetId de WA104099688 es la dirección URL de la página web de la Tienda Office para el complemento: https://store.office.com/en-001/app.aspx?assetid=WA104099688.

Los valores para el parámetro Locale y el parámetro ContentMarket son idénticos e indican el país o región desde el que intenta instalar el complemento. El formato es en-US, fr-FR, etc.

Nota:

Los complementos cargados desde la Tienda Office se actualizarán automáticamente en unos días después de que la última actualización esté disponible en la Tienda Office.

Obtener detalles de un complemento

Ejecute el cmdlet Get-OrganizationAddIn como se muestra a continuación para obtener detalles de todos los complementos cargados en el inquilino, incluido el identificador de producto de un complemento.

Get-OrganizationAddIn

Ejecute el cmdlet Get-OrganizationAddIn con un valor para el parámetro ProductId para especificar el complemento para el que desea recuperar los detalles.

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

Para obtener detalles completos de todos los complementos más los usuarios y grupos asignados, canalice la salida del cmdlet Get-OrganizationAddIn al cmdlet Format-List, como se muestra en el ejemplo siguiente.

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

Activar o desactivar un complemento

Para desactivar un complemento para que los usuarios y grupos asignados a él ya no tengan acceso, ejecute el cmdlet Set-OrganizationAddIn con el parámetro ProductId y el parámetro Enabled establecido $falseen , como se muestra en el ejemplo siguiente.

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

Para volver a activar un complemento, ejecute el mismo cmdlet con el parámetro Enabled establecido $trueen .

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

Agregar o quitar usuarios de un complemento

Para agregar usuarios y grupos a un complemento específico, ejecute el cmdlet Set-OrganizationAddInAssignments con los parámetros ProductId, Add y Members . Separe las direcciones de correo electrónico de los miembros con una coma.

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

Para quitar usuarios y grupos, ejecute el mismo cmdlet mediante el parámetro Remove .

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

Para asignar un complemento a todos los usuarios del inquilino, ejecute el mismo cmdlet mediante el parámetro AssignToEveryone con el valor establecido $trueen .

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

Para no asignar un complemento a todos y revertir a los usuarios y grupos asignados anteriormente, puede ejecutar el mismo cmdlet y desactivar el parámetro AssignToEveryone estableciendo su valor en $false.

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

Actualización de un complemento

Para actualizar un complemento desde un manifiesto, ejecute el cmdlet Set-OrganizationAddIn con los parámetros ProductId, ManifestPath y Locale , como se muestra en el ejemplo siguiente.

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

Nota:

Los complementos cargados desde la Tienda Office se actualizarán automáticamente en unos días después de que la última actualización esté disponible en la Tienda Office.

Eliminar un complemento

Para eliminar un complemento, ejecute el cmdlet Remove-OrganizationAddIn con el parámetro ProductId , como se muestra en el ejemplo siguiente.

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

Obtener ayuda detallada para cada cmdlet

Puede ver la ayuda detallada de cada cmdlet mediante el cmdlet Get-help. Por ejemplo, el siguiente cmdlet proporciona información detallada sobre el cmdlet Remove-OrganizationAddIn.

Get-help Remove-OrganizationAddIn -Full