Sdílet prostřednictvím


Get-CMCollectionMember

SYNOPSIS

Načíst členy kolekce.

SYNTAX

ByCollectionName (výchozí)

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

Rutina Get-CMCollectionMember načte členy kolekce Configuration Manager. Kolekce můžou zahrnovat zařízení nebo uživatele, ale ne obojí. Při dotazování na kolekci vrátí tato rutina objekty pro všechny členy. Výsledky můžete filtrovat podle názvu nebo ID. Tuto rutinu použijte k určení oboru dotazu pro zařízení nebo uživatele do určité kolekce.

Poznámka

Použijte například rutiny Configuration Manager z Configuration Manager jednotky webu PS XYZ:\> . Další informace najdete v tématu Začínáme.

EXAMPLES

Příklad 1: získání člena kolekce pomocí operátoru kanálu

Tento příkaz nejprve pomocí rutiny Get-CMCollection Získá objekt kolekce s názvem UserCol1. Pak pomocí operátoru kanálu předáte objektu Get-CMCollectionMember, který získá všechny členy v UserCol1. Nakonec tento příklad používá k zobrazení pouze názvů členů rutina Select-Object .

Get-CMCollection -Name "UserCol1" | Get-CMCollectionMember | Select-Object Name

Příklad 2: získání člena kolekce podle názvu

Tento příkaz se dotazuje kolekce DeviceCol1 pro členy, jejichž název začíná na domain . Zástupný znak hvězdička ( * ) odpovídá více znakům. Výsledky tak můžou zahrnovat názvy, jako je například "domain1" nebo "řadič domény".

Get-CMCollectionMember -CollectionName "DeviceCol1" -Name "domain*"

Příklad 3: Export podrobností kolekce do sdíleného svazku clusteru

V tomto příkladu se dotazuje kolekce zařízení XYZ0004B pro sadu vlastností a ukládá do proměnné $collMem. Druhý řádek převede Tato data do formátu hodnot oddělených čárkami (CSV) a výstupy do souboru.

$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

Zadejte ID kolekce, kterou chcete dotazovat. Například, "XYZ0004B".

Type: String
Parameter Sets: ByCollectionId
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CollectionName

Zadejte název kolekce, která se má dotazovat.

Type: String
Parameter Sets: ByCollectionName
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

Tento parametr považuje zástupné znaky jako literálové hodnoty znaků. Nejde kombinovat s ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučujeme). Nejde kombinovat s DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

– Položky InputObject

Zadejte objekt kolekce pro dotaz. Chcete-li získat objekt kolekce, použijte jednu z následujících rutin:

Pomocí operátoru kanálu () můžete také | předat objektu kolekce příkaz Get-CMCollectionMemeber na příkazovém řádku.

Type: IResultObject
Parameter Sets: ByCollection
Aliases: Collection

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Name

Chcete-li filtrovat výsledky, zadejte název prostředku v kolekci. U tohoto filtru se nerozlišují velká a malá písmena.

Můžete použít zástupné znaky:

  • *: Více znaků
  • ?: Jeden znak
Type: String
Parameter Sets: (All)
Aliases: ResourceName

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True

-ResourceId

Pokud chcete filtrovat výsledky, zadejte ID prostředku. Například, 16777242. Rutina vrátí pouze záznam pro daný prostředek v cílové kolekci.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

– SmsId

Chcete-li filtrovat výsledky, zadejte SMSID prostředku. Například, "GUID:7a186367-7372-4841-889e-ba2e3aad1e85". U tohoto filtru se nerozlišují velká a malá písmena.

Můžete použít zástupné znaky:

  • *: Více znaků
  • ?: Jeden znak
Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True

CommonParameters

Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement. ManagementProvider. IResultObject

OUTPUTS

System.Object

POZNÁMKY

Get-CMCollection

Get-CMDeviceCollection

Get-CMUserCollection

Get-CMDevice

Get-CMResource