New-CMCollection
Crea un dispositivo o una raccolta di 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
Utilizzare questo cmdlet per creare un dispositivo o una raccolta di utenti.
L'insieme di limitazione determina quali risorse possono essere un membro dell'insieme creato. Ad esempio, quando usi la raccolta Tutti i sistemi 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 specificare l'ambito del tipo di raccolta creato, è inoltre possibile utilizzare 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, utilizzare uno dei cmdlet per aggiungere regole di appartenenza, ad esempio:
Per ulteriori 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 ulteriori informazioni, vedere Introduzione.
Esempio
Esempio 1: Creare una raccolta utenti
Questo comando crea una raccolta di utenti 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 limiti tramite la pipeline
Questo comando utilizza innanzitutto Get-CMCollection per ottenere l'insieme All Users. Viene quindi utilizzato 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 identico all'utilizzo dei cmdlet New-CMDeviceCollection o New-CMUserCollection.
Type: | CollectionType |
Accepted values: | User, Device |
Position: | Named |
Default value: | None |
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 |
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 |
-DisableWildcardHandling
Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Questo parametro elabora i caratteri jolly e può causare un comportamento imprevisto (scelta non consigliata). Non è possibile combinarlo con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Specificare un oggetto per l'insieme di limitazione. Per ottenere questo oggetto, utilizzare i cmdlet Get-CMCollection, Get-CMDeviceCollectiono Get-CMUserCollection.
Type: | IResultObject |
Aliases: | LimitingCollection |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LimitingCollectionId
Specificare l'ID della raccolta di limitazione. Questo valore è la proprietà CollectionID, ad esempio o XYZ00012
SMS00001
.
Type: | String |
Aliases: | LimitToCollectionId |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Specificare il nome della nuova raccolta.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RefreshSchedule
Se si imposta il parametro RefreshType su Periodic
o , utilizzare questo parametro per impostare la Both
pianificazione. Specificare un oggetto di pianificazione per quando il sito esegue un aggiornamento completo dell'appartenenza alla raccolta. Per ottenere questo oggetto, utilizzare il cmdlet New-CMSchedule.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RefreshType
Specificare la modalità di aggiornamento dell'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 aggiornamenti incrementali. Se non si specifica un tipo, questo valore è il valore predefinito.Continuous
(4): Il sito valuta periodicamente le nuove risorse e quindi aggiunge nuovi membri. Questo tipo è noto anche come aggiornamento incrementale. Non viene aggiornato completamente in base a una pianificazione.Both
(6): combinazione di entrambi e , con aggiornamenti incrementali ePeriodic
un aggiornamento completo in base a unaContinuous
pianificazione.
Se si specifica o Periodic
, utilizzare il parametro Both
RefreshSchedule per impostare la pianificazione.
Nota
Il None
valore (0) è funzionalmente uguale a Manual
.
Type: | CollectionRefreshType |
Accepted values: | None, Manual, Periodic, Continuous, Both |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VariablePriority
Specifica un valore intero compreso tra 1 e 9 per la priorità delle variabili di raccolta dispositivi. 1
è la priorità più bassa ed 9
è la più alta.
Per creare variabili in una raccolta di dispositivi, utilizzare il cmdlet New-CMDeviceCollectionVariable.
Type: | Int32 |
Aliases: | DeviceCollectionVariablePrecedence |
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
IResultObject
Note
Per ulteriori informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_Collection WMI server.
Collegamenti correlati
- Copy-CMCollection
- Export-CMCollection
- Get-CMCollection
- Get-CMCollectionMember
- Get-CMCollectionSetting
- Import-CMCollection
- Invoke-CMCollectionUpdate
- Remove-CMCollection
- Set-CMCollection
- New-CMDeviceCollectionVariable
- New-CMDeviceCollection
- New-CMUserCollection
- Come creare raccolte in Configuration Manager