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>]
Описание
Используйте этот командлет, чтобы удалить правило прямого членства из коллекции устройств или пользователей.
Правило прямого членства позволяет явно выбирать члены коллекции.
Коллекции по умолчанию не имеют правил прямого членства. Любое целевое семейство должно иметь идентификатор, который начинается с кода сайта, а не SMS
.
Дополнительные сведения см . в разделе Создание коллекций в Configuration Manager.
При удалении правила прямого членства из коллекции ресурс больше не может быть членом коллекции. Это действие может привести к тому, что любое развертывание программного обеспечения или конфигурации не будет применено к ресурсу.
Примечание.
Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>
. Дополнительные сведения см. в статье Начало работы.
Примеры
Пример 1. Удаление локального компьютера из коллекции тестовых устройств
В этом примере используется переменная среды Windows ComputerName , чтобы удалить ее из коллекции с именем Test Devices. Он использует параметр Force , чтобы не запрашивать подтверждение.
Remove-CMCollectionDirectMembershipRule -CollectionName 'Test Devices' -ResourceName $env:ComputerName -Force
Параметры
-CollectionId
Укажите идентификатор коллекции с прямым правилом для удаления. Например, "XYZ0003F"
.
Тип: | String |
Aliases: | Id |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-CollectionName
Укажите имя коллекции с прямым правилом для удаления.
Тип: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Confirm
Перед запуском командлет запросит подтверждение.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Force
Выполните команду, не запрашивая подтверждение.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-InputObject
Укажите объект коллекции с прямым правилом для удаления. Чтобы получить этот объект, используйте командлеты Get-CMCollection, Get-CMDeviceCollection или Get-CMUserCollection .
Тип: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Resource
Укажите массив объектов ресурсов для удаления из коллекции. Чтобы получить этот объект, используйте командлеты Get-CMResource, Get-CMDevice или Get-CMUser .
Тип: | IResultObject[] |
Aliases: | Resources |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ResourceId
Укажите массив идентификаторов ресурсов для удаления из коллекции. Это значение является свойством ResourceId класса SMS_Resource. Например, "33555693"
.
Тип: | String[] |
Aliases: | ResourceIds |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ResourceName
Укажите массив имен ресурсов для удаления из коллекции.
Тип: | String[] |
Aliases: | ResourceNames |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | True |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Выходные данные
System.Object
Примечания
Этот командлет похож на Remove-CMDeviceCollectionDirectMembershipRule и Remove-CMUserCollectionDirectMembershipRule, которые относятся к типу коллекции. Этот командлет работает с коллекциями устройств или пользователей.
Связанные ссылки
- Get-CMCollectionDirectMembershipRule
- Remove-CMCollectionExcludeMembershipRule
- Remove-CMCollectionIncludeMembershipRule
- Remove-CMCollectionQueryMembershipRule
- Add-CMDeviceCollectionDirectMembershipRule
- Add-CMUserCollectionDirectMembershipRule
- Get-CMDeviceCollectionDirectMembershipRule
- Get-CMUserCollectionDirectMembershipRule
- Get-CMCollection
- Get-CMDeviceCollection
- Get-CMUserCollection
- Get-CMResource
- Get-CMDevice
- Get-CMUser
- Создание коллекций в Configuration Manager