Set-CMCollection
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 di 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 i cmdlet di Configuration Manager dall'unità del sito di 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 .
| Tipo: | String |
| 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 raccolta da configurare. Per ottenere questo oggetto, usare i cmdlet Get-CMCollection, Get-CMDeviceCollection o Get-CMUserCollection .
| Tipo: | IResultObject |
| Alias: | Collection |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-LimitingCollection
Specificare un oggetto per la raccolta di limitazione. Per ottenere questo oggetto, usare i cmdlet Get-CMCollection, Get-CMDeviceCollection o Get-CMUserCollection .
| Tipo: | IResultObject |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| 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: | False |
| 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: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Name
Specificare il nome di una raccolta da configurare.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-NewName
Specificare un nuovo nome per la raccolta. Usare questo parametro per rinominarlo.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | 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.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| 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 entrambiPeriodiceContinuous, 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 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 .
| 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
System.Object
Collegamenti correlati
- Copy-CMCollection
- Export-CMCollection
- Get-CMCollection
- Get-CMCollectionMember
- Get-CMCollectionSetting
- Import-CMCollection
- Invoke-CMCollectionUpdate
- New-CMCollection
- Remove-CMCollection
- Set-CMCollection
- Set-CMDeviceCollectionVariable
- Get-CMDeviceCollection
- Get-CMUserCollection
- Come creare raccolte in Configuration Manager