Condividi tramite

New-CMCollection

  • Riferimento
Modulo:
ConfigurationManager

Creare una raccolta di dispositivi o utenti.

Sintassi

New-CMCollection
   -CollectionType <CollectionType>
   [-Comment <String>]
   -LimitingCollectionName <String>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMCollection
   -CollectionType <CollectionType>
   [-Comment <String>]
   -InputObject <IResultObject>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMCollection
   -CollectionType <CollectionType>
   [-Comment <String>]
   -LimitingCollectionId <String>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per creare un dispositivo o una raccolta di utenti.

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

Per definire l'ambito del tipo di raccolta creato, è anche possibile usare i cmdlet New-CMDeviceCollection o New-CMUserCollection .

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

Per altre informazioni, vedere Come creare raccolte 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: Creare una raccolta di utenti

Questo comando crea una raccolta utente denominata testUser che imposta l'insieme All Users come raccolta di limitazione.

New-CMCollection -CollectionType User -LimitingCollectionName "All Users" -Name "testUser"

Esempio 2: Impostare la raccolta di limitazione tramite la pipeline

Questo comando usa innanzitutto Get-CMCollection per ottenere l'oggetto insieme All Users . Usa quindi l'operatore della pipeline per passare l'oggetto al cmdlet New-CMCollection , che crea una raccolta denominata testUser. La raccolta di limitazione per la nuova raccolta testUser è l'insieme All Users .

Get-CMCollection -Name "All Users" | New-CMCollection -Name "testUser" -CollectionType "User"

Parametri

-CollectionType

Specificare il tipo di raccolta da creare. Questo parametro è funzionalmente uguale all'uso dei cmdlet New-CMDeviceCollection o New-CMUserCollection .

Tipo:CollectionType
Valori accettati:User, Device
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Comment

Specificare un commento facoltativo per descrivere e identificare questa raccolta.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
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 per la raccolta di limitazione. Per ottenere questo oggetto, usare i cmdlet Get-CMCollection, Get-CMDeviceCollection o Get-CMUserCollection .

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

-LimitingCollectionId

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

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

-LimitingCollectionName

Specificare il nome della raccolta di limitazione.

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

-Name

Specificare il nome per la nuova raccolta.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 .

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

-RefreshType

Specificare come viene aggiornata l'appartenenza alla raccolta:

  • Manual (1): un amministratore attiva manualmente un aggiornamento dell'appartenenza nella console di 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.

Tipo:CollectionRefreshType
Valori accettati:None, Manual, Periodic, Continuous, Both
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 creare variabili in una raccolta di dispositivi, usare il cmdlet New-CMDeviceCollectionVariable .

Tipo:Int32
Alias:DeviceCollectionVariablePrecedence
Posizione:Named
Valore predefinito:None
Necessario:False
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

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_Collection classe WMI del server.