Agregar regla de recopilación para el módulo de integración de Configuration ManagerAdd Collection Rule Activity for Configuration Manager Integration Pack

Se aplica a: System Center 2016 - OrchestratorApplies To: System Center 2016 - Orchestrator

La actividad Agregar regla de recopilación se usa para definir la pertenencia de una colección mediante la adición de reglas de pertenencia de la colección a la colección.The Add Collection Rule activity is used to define the membership of a collection by adding collection membership rules to the collection. Las reglas de pertenencia determinan los recursos que se incluyen en la colección cuando actualiza.Membership rules determine the resources that are included in the collection when it updates. Puede usar las reglas de pertenencia para agregar un recurso específico o un conjunto de recursos de una consulta.You can use membership rules to add a specific resource or a set of resources from a query. La pertenencia a la colección también puede incluir o excluir otras colecciones.The collection membership can also include or exclude other collections. Reglas de pertenencia pueden agregar sólo aquellos recursos que son miembros de la colección de límites.Membership rules can add only those resources that are members of the limiting collection.

La actividad le permite utilizar valores separados por comas para la recopilación directa, que se incluye y reglas de recopilación excluida para definir rápidamente varias reglas de recopilación de un tipo de regla único sin tener que ejecutar la actividad varias veces.The activity allows you to use comma-separated values for direct, included collection and excluded collection rules to quickly define multiple collection rules of a single rule type without having to run the activity multiple times.

Para usar esta actividad, debe existir ya una colección, que se pueden crear mediante el crear colecciones actividad.To use this activity, a collection must already exist, which can be created by the Create Collection activity. Las reglas de pertenencia se pueden quitar de la colección mediante la Eliminar regla de recopilación actividad.Membership rules can be removed from the collection by using the Delete Collection Rule activity. Para forzar la reevaluación de la pertenencia a la colección después de agregar o quitar reglas de recopilación, use la Update Collection Membership actividad.To force re-evaluation of the collection’s membership after adding or removing collection rules, use the Update Collection Membership activity.

Para que el procedimiento para configurar este objeto, vea: Configuración de la actividad de la regla de recopilación de agregar.For the procedure to configure this object, see: Configuring the Add Collection Rule Activity.

Propiedades y los datos publicadosProperties and Published Data

Las tablas siguientes enumeran las propiedades y los datos publicados para esta actividad.The following tables list the properties and published data for this activity. La actividad publica todos los datos de las propiedades necesarias y opcionales en los datos publicados.The activity publishes all the data from the required and optional properties into published data.

Agregar propiedades de la regla de colecciónAdd Collection Rule Properties

Puede especificar las siguientes propiedades de regla:You can specify the following rule properties:

  • Colección: El nombre para mostrar o el identificador de una colección existente.Collection: The display name or ID of an existing collection.
  • Tipo de valor de colección: Indica si el valor de la propiedad de colección es un nombre de un identificador de la colección.Collection Value Type: Indicates whether the value in the Collection property is a name of a collection ID.
  • Nombre de regla: El nombre de la regla que se mostrará en la consola de Configuration Manager para las reglas de pertenencia de la colección.Rule Name: The name for the rule that will be shown in the Configuration Manager console for the collection’s membership rules.
  • Tipo de regla: El tipo de regla de pertenencia va a agregar.Rule Type: The type of membership rule to be added. Las opciones son:Options are:
    • Regla directa: un único usuario o equipoDirect Rule - a single user or computer
    • Regla de consulta - una cadena de consulta SQL o una consulta predefinida que se guardan en un administrador de configuración de servidor.Query Rule - a SQL query string or a predefined query saved on a Configuration Manager sever.
    • Incluir la recopilación: una colección cuyos miembros se van a incluidos.Include Collection - a collection whose members will be included.
    • Excluir la recopilación: una colección cuyos miembros se excluyen.Exclude Collection - a collection whose members will be excluded.
  • Definición de la regla: Los valores permitidos para una regla se determinan por el tipo de regla.Rule Definition: The allowed values for a rule are determined by the type of rule.
    • Las reglas directas pueden especificar un identificador de usuario o el dispositivo.Direct rules can specify a user or device ID. Dispositivo identificadores puede ser el nombre NetBios o la dirección IP.Device ID's can be the NetBios name or the IP address. El nombre de usuario puede ser el nombre que se muestra en la consola de Configuration Manager.The user name can be the name displayed in the Configuration Manager console. Nombres de usuario pueden ser el nombre mostrado en la consola de Configuration Manager (es decir, "contoso\Admin (Administrador)") o el valor de UniqueUserName especificado en la clase SMS_R_User en WMI (es decir, "contoso\admin")User names can be the name displayed in the Configuration Manager console (i.e. “contoso\Admin (Administrator)” ), or the UniqueUserName value specified in the SMS_R_User class in WMI (i.e. “contoso\admin”)
    • Regla de consulta: una cadena de consulta WQL válida o el identificador de la consulta de una consulta existente de Configuration ManagerQuery Rule – a valid WQL query string or the Query ID of an existing Configuration Manager Query
    • Incluyen recopilación: el nombre o identificador de colección de una colección del mismo tipo (usuario o dispositivo) como la colección especificada anteriormente.Include Collection – the name or Collection ID of a collection of the same type (user or device) as the collection specified above.
    • Excluir la colección, el nombre o identificador de colección de una colección del mismo tipo (usuario o dispositivo) como la colección especificada anteriormente.Exclude Collection – the name or Collection ID of a collection of the same type (user or device) as the collection specified above.
Nota

Al utilizar la característica de examinar para buscar un nombre de colección, o escribir manualmente un nombre de colección o de los datos publicados, debe establecer el tipo de valor de colección propiedad nombre o se producirá un error en la actividad.When you use the browse feature to look up a collection name, or enter a collection name manually or from published data, you must set the Collection Value Type property to Name or the activity will fail.

Agregar regla de recopilación de datos publicadosAdd Collection Rule Published Data

ElementoElement DescripciónDescription
ConexiónConnection Especifica el nombre de la conexión con el servidor de Configuration Manager.Specifies the name of the connection to the Configuration Manager server.
Id. de colecciónCollection ID Proporciona el valor de identificador de colección para la colección de destino para esta actividad (en caso de que se especificó el nombre de la colección para la propiedad de entrada).Provides the Collection ID value for the collection targeted for this activity (in case the collection name was specified for the input property).

Configuración de la actividad de la regla de recopilación de agregarConfiguring the Add Collection Rule Activity

Para configurar la actividad Agregar regla de recopilación:To configure the Add Collection Rule activity:

  1. Desde el actividades , arrastre un Agregar regla de recopilación actividad para el runbook activo.From the Activities pane, drag a Add Collection Rule activity to the active runbook.

  2. Haga doble clic en el Agregar regla de recopilación el icono de actividad.Double-click the Add Collection Rule activity icon. El propiedades abre el cuadro de diálogo.The Properties dialog box opens.

  3. Configurar la detalles ficha:Configuring the Details tab:

    1. En el conexión sección, haga clic en el botón de puntos suspensivos (...) y, a continuación, seleccione la conexión de servidor de Configuration Manager que desea usar para esta actividad.In the Connection section, click the ellipsis button (...), and then select the Configuration Manager server connection that you want to use for this activity. Haga clic en Aceptar.Click OK.

    2. En el campos sección, especifique un valor para cada una de las propiedades necesarias.In the Fields section, enter a value for each of the required properties. Si la propiedad está habilitada para la búsqueda, haga clic en los puntos suspensivos (...) situado junto al cuadro de texto para buscar un valor. \If the property is Lookup-enabled, you can click the ellipsis (…) button next to the text box to browse for a value.\ \ También puede utilizar los datos publicados para rellenar automáticamente el valor de la propiedad de la salida de datos por una actividad anterior en el runbook.You can also use published data to automatically populate the value of the property from the data output by a previous activity in the runbook.

  4. Para obtener información acerca de la configuración en el General y comportamiento de ejecución pestañas, consulte las actividades del Administrador de configuración.For information about the settings on the General and Run Behavior tabs, see Configuration Manager Activities.

  5. Haga clic en Finalizar.Click Finish.