Add-CMDeviceCollectionExcludeMembershipRule
Agregue una regla de pertenencia de exclusión a una colección de dispositivos.
Syntax
Add-CMDeviceCollectionExcludeMembershipRule
-CollectionName <String>
-ExcludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
-CollectionName <String>
-ExcludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
-CollectionName <String>
-ExcludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
-CollectionId <String>
-ExcludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
-CollectionId <String>
-ExcludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
-CollectionId <String>
-ExcludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
-InputObject <IResultObject>
-ExcludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
-InputObject <IResultObject>
-ExcludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
-InputObject <IResultObject>
-ExcludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Use este cmdlet para agregar una regla de pertenencia de exclusión a una colección de dispositivos. Una regla de exclusión de pertenencia excluye a los miembros de otra colección de las colecciones de dispositivos donde se aplica la regla.
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
. Puede excluir una colección predeterminada, por lo que el identificador de una colección excluida puede empezar por SMS
.
Configuration Manager actualiza dinámicamente la pertenencia de la colección de dispositivos según una programación si cambia la pertenencia de la colección excluida.
Al agregar una regla de pertenencia de exclusión a una colección, es posible que un recurso ya no sea miembro de la colección de dispositivos. Esta acción puede hacer que cualquier implementación de software o configuración no se aplique a un dispositivo.
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 Configuration Manager, por ejemploPS XYZ:\>
. Para obtener más información, consulte Introducción.
Ejemplos
Ejemplo 1: Adición de una regla de recopilación de exclusión a una colección de dispositivos
Este comando excluye los miembros de la colección predeterminada Todos los dispositivos móviles , que tiene el identificador SMSDM001, del identificador de recopilación de dispositivos XYZ00012.
Add-CMDeviceCollectionExcludeMembershipRule -CollectionId "XYZ00012" -ExcludeCollectionId "SMSDM001"
Parámetros
-CollectionId
Especifique el identificador de la colección de dispositivos para agregar la regla. Este valor es la propiedad CollectionID , por ejemplo, XYZ00012
. Dado que las colecciones predeterminadas no tienen reglas de pertenencia de exclusión, este identificador comienza con el código de sitio y no SMS
con .
Type: | String |
Aliases: | Id |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Especifique el nombre de la colección de dispositivos para agregar la regla.
Type: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcludeCollection
Especifique un objeto para que la colección excluida agregue la regla. Para obtener este objeto, use los cmdlets Get-CMCollection o Get-CMDeviceCollection .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcludeCollectionId
Especifique el identificador de la colección excluida para agregar la regla. Este valor es la propiedad CollectionID , por ejemplo, XYZ00012
. Puede excluir colecciones predeterminadas, por lo que este valor puede comenzar con el código de sitio o SMS
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcludeCollectionName
Especifique el nombre de la colección excluida para agregar la regla.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifique un objeto para que la colección de dispositivos agregue la regla. Para obtener este objeto, use los cmdlets Get-CMCollection o Get-CMDeviceCollection .
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Salidas
System.Object
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de