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 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 SMS
con .
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 SMS
con .
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 entrambiPeriodic
eContinuous
, 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
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
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per