Remove-CMUserCollectionQueryMembershipRule

  • Riferimento
Modulo:
ConfigurationManager

Rimuovere una regola di appartenenza alla query da una raccolta utenti.

Sintassi

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>]

Descrizione

Utilizzare questo cmdlet per rimuovere una regola di appartenenza alle query da una raccolta utenti. Una regola di query consente di aggiornare in modo dinamico l'appartenenza di una raccolta in base a una query eseguita in base a una pianificazione. Non è possibile rimuovere le regole di query dagli insiemi predefiniti. Qualsiasi raccolta di destinazione deve avere un ID che inizia con il codice del sito, non SMS . Per ulteriori informazioni, vedere Come creare raccolte in Configuration Manager.

Quando si rimuove una regola di appartenenza a una query da una raccolta, è possibile che più risorse non siano più membri della raccolta. Questa azione può causare la non applicazione di qualsiasi distribuzione di software o configurazione agli utenti.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\> . Per ulteriori informazioni, vedere Introduzione.

Esempio

Esempio 1: Rimuovere una regola da una raccolta utilizzando il nome della raccolta

Questo comando rimuove la regola denominata Utenti remoti per dominio dall'insieme denominato Utenti remoti.

Remove-CMUserCollectionQueryMembershipRule -CollectionName "Remote Users" -RuleName "Remote Users by Domain"

Parametri

-CollectionId

Specificare l'ID della raccolta utenti per rimuovere la regola. Questo valore è la proprietà CollectionID, ad esempio XYZ00012 . Poiché non è possibile rimuovere le regole di query dalle raccolte predefinite, questo ID inizia con il codice del sito e non con SMS .

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

-CollectionName

Specificare il nome della raccolta utenti per rimuovere la regola.

Type:String
Aliases:Name
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

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

-Force

Eseguire il comando senza chiedere conferma.

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

-InputObject

Specificare un oggetto per l'insieme di dispositivi per rimuovere la regola. Per ottenere questo oggetto, utilizzare i cmdlet Get-CMCollection o Get-CMUserCollection.

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

-RuleName

Specificare il nome della regola di query da rimuovere dall'insieme.

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

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

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

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object