Remove-CMCollectionDirectMembershipRule

Удалите правило прямого членства из устройства или коллекции пользователей.

Синтаксис

Remove-CMCollectionDirectMembershipRule
      -CollectionName <String>
      -ResourceName <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -CollectionName <String>
      -Resource <IResultObject[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -CollectionName <String>
      -ResourceId <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -CollectionId <String>
      -Resource <IResultObject[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -CollectionId <String>
      -ResourceId <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -CollectionId <String>
      -ResourceName <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -InputObject <IResultObject>
      -Resource <IResultObject[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -InputObject <IResultObject>
      -ResourceId <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -InputObject <IResultObject>
      -ResourceName <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Используйте этот комдлет, чтобы удалить правило прямого членства из устройства или коллекции пользователей. Правило прямого членства позволяет явно выбирать членов коллекции. В коллекциях по умолчанию нет правил прямого членства. В любой коллекции, на которую вы нацелены, должен быть ID, который начинается с кода сайта, а не SMS . Дополнительные сведения см. в подборке How to create collections in Configuration Manager.

При исключении правила прямого членства из коллекции ресурс больше не может быть членом коллекции. Это действие может привести к тому, что любое развертывание программного обеспечения или конфигурации не будет применяться к ресурсу.

Примечание

Запустите команды диспетчера конфигурации из диска веб-сайта Configuration Manager, например PS XYZ:\> . Дополнительные сведения см. в дополнительных сведениях о том, как начать работу.

Примеры

Пример 1. Удаление локальной машины из коллекции тестовых устройств

В этом примере используется переменная Windows среды ComputerName для удаления его из коллекции с именем Test Devices. Он использует параметр Force, чтобы не подсказыть подтверждение.

Remove-CMCollectionDirectMembershipRule -CollectionName 'Test Devices' -ResourceName $env:ComputerName -Force

Параметры

-CollectionId

Укажите ID коллекции с прямым правилом для удаления. Например, "XYZ0003F".

Type:String
Aliases:Id
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

Укажите имя коллекции с прямым правилом для удаления.

Type:String
Aliases:Name
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Перед запуском командлет запросит подтверждение.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Укажите объект коллекции с прямым правилом для удаления. Чтобы получить этот объект, используйте комлеты Get-CMCollection, Get-CMDeviceCollectionили Get-CMUserCollection.

Type:IResultObject
Aliases:Collection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Resource

Укажите массив объектов ресурсов, которые необходимо удалить из коллекции. Чтобы получить этот объект, используйте cmdlets Get-CMResource, Get-CMDeviceили Get-CMUser.

Type:IResultObject[]
Aliases:Resources
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ResourceId

Укажите массив ИД ресурсов, которые необходимо удалить из коллекции. Это значение — свойство ResourceId класса SMS_Resource. Например, "33555693".

Type:String[]
Aliases:ResourceIds
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ResourceName

Укажите массив имен ресурсов, которые необходимо удалить из коллекции.

Type:String[]
Aliases:ResourceNames
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-WhatIf

Показывает, что произойдет при запуске этого командлета. Этот комдлет не работает.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Принудительно

Запустите команду, не запрашивая подтверждения.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Выходные данные

System.Object

Примечания

Этот комлет похож на Remove-CMDeviceCollectionDirectMembershipRule и Remove-CMUserCollectionDirectMembershipRule, которые специфичнее типа коллекции. Этот комлет работает с устройствами или коллекциями пользователей.