Get-CMCollectionMember
SYNOPSIS
Hämta medlemmar i en samling.
SYNTAX
ByCollectionName (standard)
Get-CMCollectionMember -CollectionName <String> [-Name <String>] [-ResourceId <Int32>] [-SmsId <String>]
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
ByCollectionId
Get-CMCollectionMember -CollectionId <String> [-Name <String>] [-ResourceId <Int32>] [-SmsId <String>]
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
ByCollection
Get-CMCollectionMember -InputObject <IResultObject> [-Name <String>] [-ResourceId <Int32>] [-SmsId <String>]
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
DESCRIPTION
Cmdleten Get-CMCollectionMember hämtar medlemmar i en Konfigurationshanteraren samling. Samlingar kan innehålla enheter eller användare, men inte båda. När du frågar en samling returnerar denna cmdlet objekt för alla medlemmar. Du kan filtrera resultaten baserat på namn eller ID. Använd den här cmdleten för att begränsa en fråga för enheter eller användare till en specifik samling.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\>
. Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Hämta en medlem i en samling med hjälp av pipelineoperatorn
Det här kommandot använder först cmdleten Get-CMCollection för att hämta samlingsobjektet userCol1. Den använder sedan pipelineoperatorn för att skicka objektet till Get-CMCollectionMember, som hämtar alla medlemmar i UserCol1. Slutligen använder det här exemplet cmdleten Select-Object för att endast visa medlemsnamnen.
Get-CMCollection -Name "UserCol1" | Get-CMCollectionMember | Select-Object Name
Exempel 2: Hämta en medlem i en samling efter namn
Det här kommandot frågar samlingen DeviceCol1 efter medlemmar som har ett namn som börjar med domain
. Jokertecknet asterisk ( *
) matchar flera tecken. Resultatet kan därför innehålla namn som "domain1" eller "domain-controller".
Get-CMCollectionMember -CollectionName "DeviceCol1" -Name "domain*"
Exempel 3: Exportera samlingsinformation till en CSV
Det här exemplet frågar XYZ0004B-enhetssamlingen efter en uppsättning egenskaper och lagrar den i variabeln , $collMem. Den andra raden konverterar dessa data till csv-format (kommaavgränsade värden) och matas ut till en fil.
$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"
PARAMETERS
-CollectionId
Ange ID för en samling som ska frågas. Till exempel "XYZ0004B"
.
Type: String
Parameter Sets: ByCollectionId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Ange namnet på en samling som ska frågas.
Type: String
Parameter Sets: ByCollectionName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Ange ett samlingsobjekt som ska frågas. Om du vill hämta ett samlingsobjekt använder du någon av följande cmdlets:
Du kan också använda pipelineoperatorn ( ) för att skicka ett samlingsobjekt till |
Get-CMCollectionMemeber på kommandoraden.
Type: IResultObject
Parameter Sets: ByCollection
Aliases: Collection
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Om du vill filtrera resultaten anger du namnet på en resurs i samlingen. Det här filtret är inte fallkänsligt.
Du kan använda jokertecken:
*
: Flera tecken?
: Enskilt tecken
Type: String
Parameter Sets: (All)
Aliases: ResourceName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-ResourceId
Om du vill filtrera resultaten anger du ett resurs-ID. Till exempel 16777242
. Cmdleten returnerar bara en post för resursen i målsamlingen.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SmsId
Om du vill filtrera resultaten anger du SMSID för en resurs. Till exempel "GUID:7a186367-7372-4841-889e-ba2e3aad1e85"
. Det här filtret är inte fallkänsligt.
Du kan använda jokertecken:
*
: Flera tecken?
: Enskilt tecken
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
CommonParameters
Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.