New-CMDeviceCollection

Riferimento

Modulo:: ConfigurationManager

Crea una raccolta di dispositivi.

Sintassi

New-CMDeviceCollection
   [-Comment <String>]
   -LimitingCollectionName <String>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMDeviceCollection
   [-Comment <String>]
   -InputObject <IResultObject>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMDeviceCollection
   [-Comment <String>]
   -LimitingCollectionId <String>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Utilizzare questo cmdlet per creare una raccolta di dispositivi in base a una raccolta di limiti specifica. La raccolta di limitazione determina quali dispositivi possono essere membri della raccolta di dispositivi che crei. Ad esempio, quando usi l'insieme All Systems come raccolta di limitazione, la nuova raccolta può includere qualsiasi dispositivo nella gerarchia di Configuration Manager.

Puoi quindi aggiungere dispositivi alla raccolta con le regole di appartenenza. Per aggiungere membri alla raccolta di dispositivi, utilizzare uno dei cmdlet delle regole di appartenenza seguenti:

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 di dispositivi

Questo comando crea una raccolta per tutti i computer che eseguono Windows 11. Il parametro LimitingCollectionName consente di specificare che qualsiasi dispositivo nell'insieme All Systems può essere membro della nuova raccolta.

New-CMDeviceCollection -Name "Windows 11" -LimitingCollectionName "All Systems"

Parametri

-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

-InputObject

Specificare un oggetto per l'insieme di limitazione. Per ottenere questo oggetto, utilizzare i cmdlet Get-CMCollection o Get-CMDeviceCollection.

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

-LimitingCollectionName

Specificare il nome della raccolta di limitazione.

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

-Name

Specifica il nome per la nuova raccolta di dispositivi.

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 e Periodic un aggiornamento completo in base a una Continuous 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

-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