Add-CMUserCollectionExcludeMembershipRule
Adicione uma regra de associação de exclusão a uma coleção de usuários.
Syntax
Add-CMUserCollectionExcludeMembershipRule
-CollectionName <String>
-ExcludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionExcludeMembershipRule
-CollectionName <String>
-ExcludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionExcludeMembershipRule
-CollectionName <String>
-ExcludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionExcludeMembershipRule
-CollectionId <String>
-ExcludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionExcludeMembershipRule
-CollectionId <String>
-ExcludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionExcludeMembershipRule
-CollectionId <String>
-ExcludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionExcludeMembershipRule
-InputObject <IResultObject>
-ExcludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionExcludeMembershipRule
-InputObject <IResultObject>
-ExcludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionExcludeMembershipRule
-InputObject <IResultObject>
-ExcludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Use este cmdlet para adicionar uma regra de associação de exclusão a uma coleção de usuários. Uma regra de associação de exclusão exclui os membros de outra coleção das coleções de usuários em que a regra é aplicada.
Não é possível adicionar regras de associação a coleções padrão. Qualquer coleção que você direcionar deve ter uma ID que comece com o código do site, não SMS . Você pode excluir uma coleção padrão, para que a ID de uma coleção excluída possa começar com SMS .
O Configuration Manager atualiza dinamicamente a associação do conjunto de usuários em um cronograma se a associação da coleção excluída mudar.
Quando você adiciona uma regra de associação de exclusão a uma coleção, um recurso pode não ser mais membro da coleção de usuários. Essa ação pode fazer com que qualquer implantação de software ou configuração não se aplique a um usuário.
Para obter mais informações, consulte Como criar coleções no Configuration Manager.
Observação
Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.
Exemplos
Exemplo 1: Adicionar uma regra de coleção de exclusão a uma coleção de usuários
Este comando exclui os membros da coleção Remote Users, que tem a ID XYZ00017, da coleção de usuários com ID XYZ00012.
Add-CMUserCollectionExcludeMembershipRule -CollectionId "XYZ00012" -ExcludeCollectionId "XYZ00017"Parâmetros
-CollectionId
Especifique a ID do conjunto de usuários para adicionar a regra. Esse valor é a propriedade CollectionID, por exemplo, XYZ00012 . Como as coleções padrão não têm regras de associação excluídas, essa ID começa com o código do site e não SMS .
| Type: | String |
| Aliases: | Id |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionName
Especifique o nome da coleção de usuários para adicionar a regra.
| Type: | String |
| Aliases: | Name |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcludeCollection
Especifique um objeto para a coleção excluída para adicionar a regra. Para obter esse objeto, use os cmdlets Get-CMCollection ou Get-CMUserCollection.
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcludeCollectionId
Especifique a ID da coleção excluída para adicionar a regra. Esse valor é a propriedade CollectionID, por exemplo, XYZ00012 . Você pode excluir coleções padrão, para que esse valor possa começar com o código do site ou SMS .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcludeCollectionName
Especifique o nome da coleção excluída para adicionar a regra.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Especifique um objeto para o conjunto de usuários para adicionar a regra. Para obter esse objeto, use os cmdlets Get-CMCollection ou Get-CMUserCollection.
| Type: | IResultObject |
| Aliases: | Collection |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PassThru
Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
System.Object