Condividi tramite


Invoke-CMCollectionUpdate

Aggiornare l'appartenenza a una raccolta.

Sintassi

Invoke-CMCollectionUpdate
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-CMCollectionUpdate
      -CollectionId <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-CMCollectionUpdate
      -Name <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Usare questo cmdlet per aggiornare l'appartenenza a una raccolta. Il sito valuta l'appartenenza per la raccolta selezionata in base alle regole di appartenenza della raccolta. Per le raccolte con molti membri, il completamento di questo aggiornamento potrebbe richiedere del tempo.

Per altre informazioni, vedere Valutazione della raccolta in Configuration Manager.

Nota

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

Esempio

Esempio 1: Aggiornare l'appartenenza a una raccolta usando la pipeline

Questo comando ottiene l'oggetto raccolta con l'ID di XYZ00014 e usa l'operatore della pipeline per passare l'oggetto a Invoke-CMCollectionUpdate, che aggiorna l'appartenenza alla raccolta.

Get-CMCollection -Id XYZ00014 | Invoke-CMCollectionUpdate

Esempio 2: Aggiornare l'appartenenza di una raccolta in base al nome

Questo comando aggiorna l'appartenenza alla raccolta denominata UserCol1.

Invoke-CMCollectionUpdate -Name "UserCol1"

Parametri

-CollectionId

Specificare l'ID della raccolta da aggiornare. Questo valore è la proprietà CollectionID , ad esempio, XYZ00012 o SMS00001.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specificare un oggetto raccolta da aggiornare. Per ottenere questo oggetto, usare i cmdlet Get-CMCollection, Get-CMDeviceCollection o Get-CMUserCollection .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specificare il nome di una raccolta da aggiornare.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object