Get-CMCollectionMember
Ottenere i membri di un dispositivo o di una raccolta di utenti.
Sintassi
Get-CMCollectionMember
-CollectionName <String>
[-Name <String>]
[-ResourceId <Int32>]
[-SmsId <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Get-CMCollectionMember
-CollectionId <String>
[-Name <String>]
[-ResourceId <Int32>]
[-SmsId <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Get-CMCollectionMember
-InputObject <IResultObject>
[-Name <String>]
[-ResourceId <Int32>]
[-SmsId <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Descrizione
Utilizzare questo cmdlet per ottenere i membri di una raccolta. Le raccolte possono includere dispositivi o utenti, ma non entrambi. Quando si esegue una query su un insieme, questo cmdlet restituisce oggetti per tutti i membri.
Per ulteriori informazioni, vedere Introduzione alle 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: Ottenere un membro di una raccolta utilizzando l'operatore della pipeline
Questo comando utilizza innanzitutto il cmdlet Get-CMCollection per ottenere l'oggetto insieme denominato UserCol1. Viene quindi utilizzato l'operatore della pipeline per passare l'oggetto a Get-CMCollectionMember, che ottiene tutti i membri dell'insieme. Infine, in questo esempio viene utilizzato il cmdlet Select-Object per visualizzare solo i nomi dei membri.
Get-CMCollection -Name "UserCol1" | Get-CMCollectionMember | Select-Object Name
Esempio 2: Ottenere un membro di una raccolta in base al nome
Questo comando esegue una query sull'insieme DeviceCol1 per i membri il cui nome inizia con domain
. Il carattere jolly asterisco ( *
) corrisponde a più caratteri. I risultati possono pertanto includere nomi quali "dominio1" o "controller di dominio".
Get-CMCollectionMember -CollectionName "DeviceCol1" -Name "domain*"
Esempio 3: Esportare i dettagli della raccolta in un file CSV
Questo esempio esegue una query sull'insieme di dispositivi XYZ0004B per un set di proprietà e lo archivia nella variabile $collMem. Nella seconda riga i dati vengono convertiti in formato CSV (Comma Separated Value) e vengono restituiti in un file.
$collMem = Get-CMCollectionMember -CollectionId "XYZ0004B" | Select-Object Name,Domain,LastLogonUser,DeviceOS,DeviceOSBuild,MACAddress,SerialNumber
$collMem | ConvertTo-Csv -NoTypeInformation | Out-File -FilePath "C:\output\XYZ0004B.csv"
Parametri
-CollectionId
Specificare l'ID di una raccolta su cui eseguire una query. Ad esempio, "XYZ0004B"
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Specificare il nome di una raccolta su cui eseguire una query.
Type: | String |
Position: | Named |
Default value: | None |
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 insieme su cui eseguire una query. Per ottenere un oggetto insieme, utilizzare uno dei cmdlet seguenti:
È inoltre possibile utilizzare l'operatore pipeline ( ) per passare un oggetto |
insieme a Get-CMCollectionMemeber nella riga di comando.
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Per filtrare i risultati, specificare il nome di una risorsa nell'insieme. Questo filtro non fa distinzione tra maiuscole e minuscole.
È possibile utilizzare i caratteri jolly:
*
: più caratteri?
: carattere singolo
Type: | String |
Aliases: | ResourceName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-ResourceId
Per filtrare i risultati, specificare un ID risorsa. Ad esempio, 16777242
. Il cmdlet restituisce solo un record per la risorsa nella raccolta di destinazione.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SmsId
Per filtrare i risultati, specificare l'SMSID di una risorsa. Ad esempio, "GUID:7a186367-7372-4841-889e-ba2e3aad1e85"
. Questo filtro non fa distinzione tra maiuscole e minuscole.
È possibile utilizzare i caratteri jolly:
*
: più caratteri?
: carattere singolo
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
Input
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Output
System.Object