Compartir a través de

Ejemplo: Agregar una entidad de seguridad (usuario o equipo) a una cola (con enlace en tiempo de compilación)

  • Artículo

Este ejemplo muestra cómo otorgar a un usuario o equipo acceso a una cola. AddPrincipalToQueueRequest agrega el principal especificado a la lista de miembros de la cola. Si la entidad de seguridad pasada es un equipo, cada miembro del equipo se agrega a la cola. Puede descargar el ejemplo desde aquí.

Cómo ejecutar esta muestra

Para obtener una copia local de todas las muestras y compilarlas, siga estos pasos:

  1. Descargar o clonar el informe de Muestras para que tenga una copia local.
  2. (Opcional) Edite el archivo dataverse/App.config para definir una cadena de conexión que especifique la instancia o la organización a la que desea conectarse.
  3. Abra la solución de ejemplo en Visual Studio y presione F5 para ejecutar la muestra. Una vez que especifique una cadena de conexión en dataverse/App.config, cualquier muestra que ejecute utilizará esa información de conexión.

Si no especifica una cadena de conexión en el archivo dataverse/App.config, se abre un diálogo cada vez que ejecute la muestra y tendrá que introducir información acerca de a qué instancia u org desea conectarse y qué credenciales desea usar. Este diálogo guardará en caché conexiones anteriores para que pueda elegir una conexión usada previamente.

Qué hace este ejemplo

El mensaje AddPrincipalToQueueRequest está diseñado para usarse en un escenario donde contenga datos necesarios para agregar el principal especificado a la lista de miembros de la cola. Si el principal es un equipo, agregue cada miembro del equipo a la cola.

Cómo funciona esta muestra

Para simular el escenario descrito en Qué hace este ejemplo, la muestra hará lo siguiente:

Configuración

  1. Comprobaciones para la versión actual de la organización.
  2. El método Queue crea una instancia de cola y establece sus valores de propiedad. Las GUID devueltas se almacenan en una variable.
  3. QueryExpression recupera la unidad de negocio predeterminada para la creación del equipo y del rol.
  4. Crea un nuevo equipo y rol de ejemplo necesarios para el ejemplo.
  5. Recupera los privilegios prvReadQueue y prvAppendToQueue.
  6. El método AddPrivilegeRoleRequest agrega los privilegios prvReadQueue y prvAppendToQueue al rol de ejemplo.

Demostración

El método AddPrincipalToQueueRequest agrega el equipo a la cola.

Limpiar

Muestra una opción para eliminar los datos de ejemplo en Configuración. La eliminación es opcional en caso de que desee examinar las entidades y los datos creados por el ejemplo. Puede eliminar manualmente los registros para obtener el mismo resultado.