Dela via


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.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

ANTECKNINGAR

Get-CMCollection

Get-CMDeviceCollection

Get-CMUserCollection

Get-CMDevice

Get-CMResource