Compartir a través de

Propiedades del espacio empresarial de SharePoint Online

  • Artículo

Las propiedades de inquilino permiten a los administradores de inquilinos agregar propiedades en el catálogo de aplicaciones que se pueden leer mediante la API de REST de SharePoint.

Opciones para trabajar con propiedades de inquilino

Los administradores de inquilinos administran las propiedades del inquilino mediante una de las siguientes opciones:

API de REST de SharePoint

Obtenga más información aquí: API de REST de SharePoint

Shell de administración de Microsoft SharePoint Online

Los administradores de inquilinos administran las propiedades del espacio empresarial mediante el Shell de administración de Microsoft SharePoint Online, un módulo de PowerShell de Microsoft que es usado para administrar la suscripción de SharePoint Online en Office 365.

Antes de usar cualquiera de los cmdlets en el módulo Shell de Administración de Microsoft SharePoint Online, primero debe conectarse a SharePoint Online mediante el cmdlet Connect-SPOService. Todas las propiedades de inquilino se administran mediante los cmdlets de *-SPOStorageEntity.

Obtenga más información aquí: Shell de administración de Microsoft SharePoint Online

PnP PowerShell

La ventaja de PnP PowerShell es que no requiere privilegios de administrador de inquilinos para establecer esas propiedades. Lo puede hacer cualquier miembro del grupo de propietarios de un sitio de catálogo de aplicaciones. Esto es aplicable al sitio del catálogo de aplicaciones del espacio empresarial y catálogos de aplicaciones de colección de sitios.

Previamente a utilizar cualquiera de los cmdlets del módulo PnP PowerShell, deberá conectarse primeramente a SharePoint Online utilizando el cmdlet.Connect-PnPOnline Todas las propiedades de inquilino se administran mediante los cmdlets de *-PnPStorageEntity.

Obtenga más información aquí: PowerShell de PnP

Importante

Puede conectarse a cualquier sitio mediante el cmdlet Connect-PnPOnline. Cuando omite el parámetro -Scope o lo establece en Tenant (que es el valor predeterminado), todos los cmdlets se aplican al catálogo de aplicaciones del inquilino, independientemente del sitio al que se haya conectado. Si establece el parámetro -Scope en Site todos los cmdlets se aplicarán al catálogo de aplicaciones de la colección de sitios del sitio al que se ha conectado.

Nota:

PnP PowerShell es una solución de código abierto con una comunidad activa que ofrece su soporte. No hay ningún contrato de nivel de servicio para el soporte de la herramienta de código abierto de Microsoft.

CLI de Microsoft 365

La CLI para Microsoft 365 se puede usar para administrar las propiedades del inquilino. La CLI de Microsoft 365 es una interfaz de línea de comandos multiplataforma que se puede usar en cualquier plataforma, incluidas Windows, macOS y Linux.

Antes de usar cualquiera de los comandos de la CLI para Microsoft 365, primero debe conectarse al inquilino de Microsoft 365 mediante el comando m365 login. Todas las propiedades del espacio empresarial de SharePoint Online se administran mediante los comandos spo storageentity.

Obtenga más información aquí: CLI de Microsoft 365

Importante

Las propiedades del espacio empresarial se almacenan en el sitio del catálogo de aplicaciones asociado a dicho espacio empresarial. Para establecer o quitar una propiedad, debe especificar la dirección URL absoluta del sitio del catálogo de aplicaciones. Si especifica la dirección URL de un sitio diferente del catálogo de aplicaciones, obtendrá un error de acceso denegado.

Nota:

La CLI de Microsoft 365 es una solución de código abierto con una comunidad activa que ofrece su soporte. No hay ningún contrato de nivel de servicio para el soporte de la herramienta de código abierto de Microsoft.

Enumerar propiedades de inquilino

Las siguientes opciones muestran cómo enumerar las propiedades de inquilino de SharePoint Online.

Solicitud

GET https://tenant.sharepoint.com/sites/site/_api/web/AllProperties?$select=storageentitiesindex

Respuesta

HTTP/1.1 200 OK
Content-Type: application/json
{
  "key": {
    "Comment":"Tenant property comment.",
    "Description":"Tenant property description",
    "Value":"Tenant property key value"
  }
}

Obtener o leer propiedades de inquilino

Las siguientes opciones muestran cómo obtener propiedades de inquilino de SharePoint Online.

Solicitud

GET https://tenant.sharepoint.com/sites/site/_api/web/GetStorageEntity('key')

Respuesta

HTTP/1.1 200 OK
Content-Type: application/json
{
  "Comment":"Tenant property comment.",
  "Description":"Tenant property description",
  "Value":"Tenant property key value"
}

Establecer o escribir propiedades de inquilino

Las siguientes opciones muestran cómo escribir propiedades de inquilino desde SharePoint Online.

No admitido

Quitar propiedades de inquilino

Las siguientes opciones muestran cómo quitar propiedades de inquilino de SharePoint Online.

No admitido

Scripts personalizados y catálogos de aplicaciones de colección de sitios

Solo se permite establecer propiedades de inquilino en catálogos de aplicaciones de colección de sitios en sitios que tienen habilitados scripts personalizados. Al intentar establecer una propiedad de inquilino en un "sitio sin scripts", se mostrará el siguiente error:

Access denied. You do not have permission to perform this action or access this resource.

Puede obtener más información sobre los scripts personalizados aquí: Allow or prevent custom script (Permitir o impedir el uso de scripts personalizados).

El mensaje de error también se mostrará si no es propietario o administrador de la colección de sitios del sitio.

Vea también