Get-CMCollection
Ottenere un oggetto raccolta di dispositivi o utenti.
Sintassi
Get-CMCollection
[-CollectionType <CollectionType>]
[-Name <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Get-CMCollection
[-CollectionType <CollectionType>]
-DistributionPointGroup <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Get-CMCollection
[-CollectionType <CollectionType>]
-DistributionPointGroupId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Get-CMCollection
[-CollectionType <CollectionType>]
-DistributionPointGroupName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Get-CMCollection
[-CollectionType <CollectionType>]
-Id <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Descrizione
Usare questo cmdlet per ottenere un dispositivo o un oggetto raccolta utenti.
Le raccolte consentono di organizzare le risorse in unità gestibili. È possibile creare raccolte in base alle esigenze di gestione client ed eseguire operazioni su più risorse contemporaneamente. La maggior parte delle attività di gestione si basa o richiede l'uso di una o più raccolte.
Per definire l'ambito del tipo di raccolta ottenuto, usare i cmdlet Get-CMDeviceCollection o Get-CMUserCollection .
Se non si specifica una raccolta per nome, ID o oggetto, questo cmdlet restituisce tutte le raccolte.
Per altre informazioni, vedere Introduzione alle 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: Ottenere una raccolta per nome
Questo comando ottiene la raccolta denominata testUser.
Get-CMCollection -Name "testUser"
Esempio 2: Ottenere una raccolta per un gruppo di punti di distribuzione
Questo comando ottiene l'oggetto gruppo di punti di distribuzione denominato dpg1 e usa l'operatore della pipeline per passare l'oggetto a Get-CMCollection, che ottiene le raccolte associate al gruppo di punti di distribuzione.
Get-CMDistributionPointGroup -Name "dpg1" | Get-CMCollection
Quando si distribuisce contenuto a queste raccolte, il sito viene automaticamente distribuito a tutti i membri correnti di questo gruppo di punti di distribuzione. Per altre informazioni, vedere Gestire i gruppi di punti di distribuzione.
Parametri
-CollectionType
Filtrare il tipo di raccolta da ottenere. Questo parametro è funzionalmente identico all'uso dei cmdlet Get-CMDeviceCollection o Get-CMUserCollection .
Type: | CollectionType |
Accepted values: | User, Device |
Position: | Named |
Default value: | None |
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 |
-DistributionPointGroup
Specificare un oggetto gruppo di punti di distribuzione associato a questa raccolta. Per ottenere questo oggetto, usare il cmdlet Get-CMDistributionPointGroup .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DistributionPointGroupId
Specificare il GUID per un gruppo di punti di distribuzione associato a questa raccolta. Questo valore è la proprietà GroupID , ovvero un GUID standard racchiuso tra parentesi graffe, {537e6303-69eb-4104-bf7b-7baf43ce2352}
ad esempio .
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributionPointGroupName
Specificare il nome di un gruppo di punti di distribuzione associato a questa raccolta.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
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 |
-Id
Specificare l'ID della raccolta da ottenere. Questo valore è la proprietà CollectionID , ad esempio, XYZ00012
o SMS00001
.
Type: | String |
Aliases: | CollectionId |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Specificare il nome della raccolta da ottenere.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
Input
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Output
IResultObject[]
IResultObject
Note
Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_Collection classe WMI del server.
Collegamenti correlati
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