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.