Share via

Remove-CMUserCollectionDirectMembershipRule

  • Referência
Módulo:
ConfigurationManager

Remova uma regra de associação direta de uma coleção de usuários.

Syntax

Remove-CMUserCollectionDirectMembershipRule
      -CollectionName <String>
      -ResourceName <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMUserCollectionDirectMembershipRule
      -CollectionName <String>
      -Resource <IResultObject[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMUserCollectionDirectMembershipRule
      -CollectionName <String>
      -ResourceId <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMUserCollectionDirectMembershipRule
      -CollectionId <String>
      -Resource <IResultObject[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMUserCollectionDirectMembershipRule
      -CollectionId <String>
      -ResourceId <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMUserCollectionDirectMembershipRule
      -CollectionId <String>
      -ResourceName <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMUserCollectionDirectMembershipRule
      -InputObject <IResultObject>
      -Resource <IResultObject[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMUserCollectionDirectMembershipRule
      -InputObject <IResultObject>
      -ResourceId <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMUserCollectionDirectMembershipRule
      -InputObject <IResultObject>
      -ResourceName <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Use esse cmdlet para remover uma regra de associação direta de uma coleção de usuários. Uma regra de associação direta permite que você escolha explicitamente os membros da coleção de usuários. Coleções padrão não têm regras de associação diretas. Qualquer coleção direcionada 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 direta de uma coleção, o recurso pode não ser mais um membro da coleção. Essa ação pode fazer com que qualquer implantação de software ou configuração não se aplique ao usuário.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: remover uma regra de associação direta de uma coleção de usuários

Esse comando remove a regra de associação direta para o recurso com ID 33555693 da coleção de usuários que tem a ID XYZ0001A.

Remove-CMUserCollectionDirectMembershipRule -CollectionID "XYZ0001A" -ResourceId "33555693"

Parâmetros

-CollectionId

Especifique a ID da coleção de usuários com a regra direta a ser removida. Por exemplo, "XYZ0003F".

Type:String
Aliases:Id
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

Especifique o nome da coleção de usuários com a regra direta a ser removida.

Type:String
Aliases:Name
Position:Named
Default value:None
Required:True
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Execute o comando sem pedir confirmação.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifique um objeto de coleção de usuário com a regra direta a ser removida. Para obter esse objeto, use os cmdlets Get-CMCollection ou Get-CMUserCollection .

Type:IResultObject
Aliases:Collection
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Resource

Especifique uma matriz de objetos de recurso para remover da coleção de usuários. Para obter esse objeto, use os cmdlets Get-CMResource ou Get-CMUser .

Type:IResultObject[]
Aliases:Resources
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceId

Especifique uma matriz de IDs de recurso para remover da coleção de usuários. Esse valor é a propriedade ResourceId da classe SMS_Resource. Por exemplo, "33555693".

Type:String[]
Aliases:ResourceIds
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceName

Especifique uma matriz de nomes de recursos para remover as regras de associação direta da coleção de usuários.

Type:String[]
Aliases:ResourceNames
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object