Add-CMDeviceCollectionDirectMembershipRule
Добавьте правило прямого членства в коллекцию устройств.
Синтаксис
Add-CMDeviceCollectionDirectMembershipRule
-CollectionId <String>
[-PassThru]
-ResourceId <Int32[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
-CollectionId <String>
[-PassThru]
-Resource <IResultObject[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
-CollectionName <String>
[-PassThru]
-ResourceId <Int32[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
-CollectionName <String>
[-PassThru]
-Resource <IResultObject[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
-InputObject <IResultObject>
[-PassThru]
-ResourceId <Int32[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
-InputObject <IResultObject>
[-PassThru]
-Resource <IResultObject[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Используйте этот комлет, чтобы добавить правило прямого членства в коллекцию устройств.
Правило прямого членства позволяет явно выбирать членов коллекции устройств.
Нельзя добавлять правила членства в коллекции по умолчанию. В любой коллекции, на которую вы нацелены, должен быть ID, который начинается с кода сайта, а не SMS
.
Дополнительные сведения см. в подборке How to create collections in Configuration Manager.
Примечание
Запустите команды диспетчера конфигурации из диска веб-сайта Configuration Manager, например PS XYZ:\>
. Дополнительные сведения см. в дополнительных сведениях о том, как начать работу.
Примеры
Пример 1. Добавление правила прямого членства
Эта команда добавляет правило прямого членства в коллекцию устройств с ID XYZ00056. Он добавляет ресурс с 16777219 в коллекцию.
Add-CMDeviceCollectionDirectMembershipRule -CollectionId "XYZ00056" -ResourceId 16777219
Пример 2. Добавление правила прямого членства с помощью конвейера
Эта команда сначала использует командлет Get-CMCollection для получения объекта коллекции с именем testCollection. Затем оператор конвейера передает объект в кодлет Add-CMDeviceCollectionDirectMembershipRule, который добавляет правило прямого членства в объект коллекции устройств. Он добавляет устройство с 16777219 в коллекцию.
Get-CMCollection -Name "testCollection" | Add-CMDeviceCollectionDirectMembershipRule -ResourceId 16777219
Параметры
-CollectionId
Укажите ID коллекции устройств, чтобы добавить правило. Это значение является свойством CollectionID, XYZ00012
например. Так как вы не можете добавить правила членства в коллекции по умолчанию, этот код начинается с кода сайта, а не SMS
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Укажите имя коллекции устройств, чтобы добавить правило.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Перед запуском командлет запросит подтверждение.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Этот параметр рассматривает символы под диктовки как буквальные значения символов. Вы не можете объединить его с ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Этот параметр обрабатывает символы под диктовки и может привести к неожиданному поведению (не рекомендуется). Вы не можете объединить его с DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Укажите объект для коллекции устройств, чтобы добавить правило. Чтобы получить этот объект, используйте cmdlets Get-CMCollection или Get-CMDeviceCollection.
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Добавьте этот параметр, чтобы вернуть объект, который представляет элемент, с которым вы работаете. По умолчанию этот комдлет может не создавать выходных данных.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Resource
Укажите массив объектов ресурсов для добавления в коллекцию устройств с помощью этого правила прямого членства. Чтобы получить этот объект, используйте cmdlet Get-CMResource или cmdlet Get-CMDevice с -Resource
параметром.
Type: | IResultObject[] |
Aliases: | Resources |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceId
Укажите массив ID-данных ресурсов, которые необходимо добавить в коллекцию устройств с помощью этого правила прямого членства. Это значение является свойством ResourceID, например 16777219
.
Type: | Int32[] |
Aliases: | ResourceIds |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Этот комдлет не работает.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Выходные данные
System.Object