Remove-CMCollectionIncludeMembershipRule
Remova uma regra de associação include de um dispositivo ou conjunto de usuários.
Syntax
Remove-CMCollectionIncludeMembershipRule
-CollectionName <String>
-IncludeCollectionName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-CollectionName <String>
-IncludeCollection <IResultObject>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-CollectionName <String>
-IncludeCollectionId <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-CollectionId <String>
-IncludeCollection <IResultObject>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-CollectionId <String>
-IncludeCollectionId <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-CollectionId <String>
-IncludeCollectionName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-InputObject <IResultObject>
-IncludeCollection <IResultObject>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-InputObject <IResultObject>
-IncludeCollectionId <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-InputObject <IResultObject>
-IncludeCollectionName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Use este cmdlet para remover uma regra de associação include de um dispositivo ou conjunto de usuários. Uma regra de associação include inclui os membros de outra coleção na coleção em que a regra é aplicada.
Para obter mais informações, consulte Como criar coleções no Configuration Manager.
Quando você remove uma regra de associação include para uma coleção, um recurso pode não ser mais membro da coleção. Essa ação pode fazer com que qualquer implantação de software ou configuração não se aplique a um recurso.
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 associação include
Este comando remove a regra de associação incluir para a coleção All Systems da coleção device chamada Devices. A especificação do parâmetro Force indica que a regra de associação foi removida sem solicitar a você.
Remove-CMCollectionIncludeMembershipRule -CollectionName "Devices" -IncludeCollectionName "All Systems" -Force
Exemplo 2: Remover uma regra de associação incluir usando o pipeline
Este comando primeiro usa o cmdlet Get-CMCollection para obter o objeto da coleção user chamado Users. Em seguida, ele usa o operador de pipeline para passar o objeto para o cmdlet Remove-CMCollectionIncludeMembershipRule.
Get-CMCollection -Name "Users" | Remove-CMCollectionIncludeMembershipRule -IncludeCollectionName "All Users" -Force
Parâmetros
-CollectionId
Especifique a ID da coleção para remover a regra. Esse valor é a propriedade CollectionID, por exemplo, XYZ00012
. Como as coleções padrão não incluem regras de associaçã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 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: | None |
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 |
-IncludeCollection
Especifique um objeto para a coleção incluída para remover a regra. Para obter esse objeto, use os cmdlets Get-CMCollection, Get-CMDeviceCollectionou Get-CMUserCollection.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeCollectionId
Especifique a ID da coleção incluída para remover a regra. Esse valor é a propriedade CollectionID, por exemplo, XYZ00012
. Você pode incluir 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 |
-IncludeCollectionName
Especifique o nome da coleção incluída para remover a regra.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifique um objeto para que a coleção remova a regra. Para obter esse objeto, use os cmdlets Get-CMCollection, Get-CMDeviceCollectionou Get-CMUserCollection.
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
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: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
System.Object
Observações
Este cmdlet é semelhante a Remove-CMDeviceCollectionIncludeMembershipRule e Remove-CMUserCollectionIncludeMembershipRule, que são específicos do tipo de coleção. Este cmdlet funciona com coleções de dispositivos ou usuários.
Links Relacionados
- Get-CMCollectionIncludeMembershipRule
- Remove-CMCollectionDirectMembershipRule
- Remove-CMCollectionExcludeMembershipRule
- Remove-CMCollectionQueryMembershipRule
- Add-CMDeviceCollectionIncludeMembershipRule
- Add-CMUserCollectionIncludeMembershipRule
- Get-CMDeviceCollectionIncludeMembershipRule
- Get-CMUserCollectionIncludeMembershipRule
- Get-CMCollection
- Get-CMDeviceCollection
- Get-CMUserCollection
- Como criar coleções no Configuration Manager