Add-CMUserCollectionDirectMembershipRule
Agregue una regla de pertenencia directa a una colección de usuarios.
Sintaxis
Add-CMUserCollectionDirectMembershipRule
-InputObject <IResultObject>
[-PassThru]
-Resource <IResultObject[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionDirectMembershipRule
-CollectionId <String>
[-PassThru]
-ResourceId <Int32[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionDirectMembershipRule
-CollectionId <String>
[-PassThru]
-Resource <IResultObject[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionDirectMembershipRule
-CollectionName <String>
[-PassThru]
-ResourceId <Int32[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionDirectMembershipRule
-CollectionName <String>
[-PassThru]
-Resource <IResultObject[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionDirectMembershipRule
-InputObject <IResultObject>
[-PassThru]
-ResourceId <Int32[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Use este cmdlet para agregar una regla de pertenencia directa a una colección de usuarios.
Una regla de pertenencia directa le permite elegir explícitamente los miembros de la colección de usuarios.
No se pueden agregar reglas de pertenencia a colecciones predeterminadas. Cualquier colección de destino debe tener un identificador que comience con el código de sitio, no SMS.
Para obtener más información, consulte Creación de colecciones en Configuration Manager.
Nota:
Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.
Ejemplos
Ejemplo 1: Adición de una regla de pertenencia directa a una colección de usuarios
Este comando agrega una regla de pertenencia directa a la colección de usuarios con el identificador XYZ00057. Agrega el recurso con el identificador 16777210 a la colección.
Add-CMUserCollectionDirectMembershipRule -CollectionId "XYZ00057" -ResourceId "16777210"Parámetros
-CollectionId
Especifique el identificador de la colección de usuarios para agregar la regla. Este valor es la propiedad CollectionID , por ejemplo, XYZ00012. Dado que no puede agregar reglas de pertenencia a colecciones predeterminadas, este identificador comienza con el código de sitio y no SMScon .
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-CollectionName
Especifique el nombre de la colección de usuarios para agregar la regla.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-InputObject
Especifique un objeto para que la colección de usuarios agregue la regla. Para obtener este objeto, use los cmdlets Get-CMCollection o Get-CMUserCollection .
| Tipo: | IResultObject |
| Alias: | Collection |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-PassThru
Agregue este parámetro para devolver un objeto que represente el elemento con el que está trabajando. De forma predeterminada, este cmdlet no puede generar ninguna salida.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Resource
Especifique una matriz de objetos de recurso para agregar a la colección de usuarios con esta regla de pertenencia directa. Para obtener este objeto, use los cmdlets Get-CMResource o Get-CMUser .
| Tipo: | IResultObject[] |
| Alias: | Resources |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-ResourceId
Especifique una matriz de identificadores de los recursos que se van a agregar a la colección de usuarios con esta regla de pertenencia directa. Este valor es la propiedad ResourceID , por ejemplo 16777219.
| Tipo: | Int32[] |
| Alias: | ResourceIds |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
Salidas
System.Object