Set-CMCollection

  • Riferimento
Modulo:
ConfigurationManager

Configurare una raccolta di dispositivi o utenti.

Sintassi

Set-CMCollection
   [-Comment <String>]
   -InputObject <IResultObject>
   [-LimitingCollection <IResultObject>]
   [-LimitingCollectionId <String>]
   [-LimitingCollectionName <String>]
   [-NewName <String>]
   [-PassThru]
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMCollection
   -CollectionId <String>
   [-Comment <String>]
   [-LimitingCollection <IResultObject>]
   [-LimitingCollectionId <String>]
   [-LimitingCollectionName <String>]
   [-NewName <String>]
   [-PassThru]
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMCollection
   [-Comment <String>]
   [-LimitingCollection <IResultObject>]
   [-LimitingCollectionId <String>]
   [-LimitingCollectionName <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per configurare una raccolta di dispositivi o utenti.

La raccolta di limitazione determina quali risorse possono essere membro della raccolta. Ad esempio, quando si usa la raccolta All Systems come raccolta di limitazione, la nuova raccolta può includere qualsiasi dispositivo nella gerarchia Configuration Manager.

Aggiungere risorse alla raccolta con regole di appartenenza. Per aggiungere membri alla raccolta, usare uno dei cmdlet per aggiungere regole di appartenenza, ad esempio:

Non è possibile configurare le raccolte predefinite. Qualsiasi raccolta di destinazione deve avere un ID che inizia con il codice del sito, non SMScon .

Per altre informazioni, vedere Come creare raccolte in Configuration Manager.

Nota

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

Esempio

Esempio 1: Rinominare una raccolta

Il primo comando ottiene l'oggetto raccolta denominato testUser e lo archivia nella variabile $userCollection .

Il secondo comando aggiorna il nome della raccolta.

$userCollection = Get-CMCollection -Name "testUser"
Set-CMCollection -InputObject $userCollection -NewName "newTestUser"

Parametri

-CollectionId

Specificare l'ID della raccolta da configurare. Questo valore è la proprietà CollectionID , ad esempio XYZ00012. Non è possibile configurare le raccolte predefinite, quindi questo valore inizia con il codice del sito, non SMScon .

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

-Comment

Specificare un commento facoltativo per descrivere e identificare questa raccolta.

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-InputObject

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

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

-LimitingCollection

Specificare un oggetto per la raccolta di limitazione. Per ottenere questo oggetto, usare i cmdlet Get-CMCollection, Get-CMDeviceCollection o Get-CMUserCollection .

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

-LimitingCollectionId

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

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

-LimitingCollectionName

Specificare il nome della raccolta di limitazione.

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

-Name

Specificare il nome di una raccolta da configurare.

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

-NewName

Specificare un nuovo nome per la raccolta. Usare questo parametro per rinominarlo.

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

-PassThru

Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

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

-RefreshSchedule

Se si imposta il parametro RefreshType su Periodic o Both, utilizzare questo parametro per impostare la pianificazione. Specificare un oggetto pianificazione per quando il sito esegue un aggiornamento completo dell'appartenenza alla raccolta. Per ottenere questo oggetto, usare il cmdlet New-CMSchedule .

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

-RefreshType

Specificare come viene aggiornata l'appartenenza alla raccolta:

  • Manual(1): un amministratore attiva manualmente un aggiornamento dell'appartenenza nella console Configuration Manager o con il cmdlet Invoke-CMCollectionUpdate.
  • Periodic (2): il sito esegue un aggiornamento completo in base a una pianificazione. Non usa gli aggiornamenti incrementali. Se non si specifica un tipo, questo valore è quello predefinito.
  • Continuous (4): il sito valuta periodicamente le nuove risorse e quindi aggiunge nuovi membri. Questo tipo è noto anche come aggiornamento incrementale. Non esegue un aggiornamento completo in base a una pianificazione.
  • Both (6): combinazione di entrambi Periodic e Continuous, con aggiornamenti incrementali e un aggiornamento completo in base a una pianificazione.

Se si specifica Periodic o Both, utilizzare il parametro RefreshSchedule per impostare la pianificazione.

Nota

Il None valore (0) funziona come Manual.

Type:CollectionRefreshType
Accepted values:None, Manual, Periodic, Continuous, Both
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VariablePriority

Specificare un valore intero compreso tra 1 e 9 per la priorità delle variabili di raccolta dei dispositivi. 1 è la priorità più bassa ed 9 è la più alta.

Per configurare le variabili in una raccolta di dispositivi, usare il cmdlet Set-CMDeviceCollectionVariable .

Per visualizzare la priorità della variabile corrente, usare il cmdlet Get-CMCollectionSetting .

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

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object