Remove-CMUserCollectionQueryMembershipRule
Remova uma regra de associação de consulta de uma coleção de usuários.
Syntax
Remove-CMUserCollectionQueryMembershipRule
-InputObject <IResultObject>
-RuleName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMUserCollectionQueryMembershipRule
-CollectionName <String>
-RuleName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMUserCollectionQueryMembershipRule
-CollectionId <String>
-RuleName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Use este cmdlet para remover uma regra de associação de consulta de uma coleção de usuários.
Uma regra de consulta permite atualizar dinamicamente a associação de uma coleção com base em uma consulta que é executado em um cronograma.
Não é possível remover as regras de consulta das 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
.
Para obter mais informações, consulte Como criar coleções no Configuration Manager.
Quando você remove uma regra de associação de consulta de uma coleção, vários recursos podem não ser mais membros da coleção. Essa ação pode fazer com que qualquer implantação de software ou configuração não se aplique aos usuários.
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: Remover uma regra de uma coleção usando o nome da coleção
Este comando remove a regra chamada Usuários Remotos por Domínio da coleção chamada Remote Users.
Remove-CMUserCollectionQueryMembershipRule -CollectionName "Remote Users" -RuleName "Remote Users by Domain"
Parâmetros
-CollectionId
Especifique a ID do conjunto de usuários para remover a regra. Esse valor é a propriedade CollectionID, por exemplo, XYZ00012
. Como você não pode remover as regras de consulta de coleções padrão, 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 remover 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 |
-Força
Execute o comando sem pedir confirmação.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifique um objeto para que a coleção de dispositivos remova 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 |
-RuleName
Especifique o nome da regra de consulta a ser removido da coleção.
Type: | String |
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