New-CMCollection
SYNOPSIS
Vytvoří Správce konfigurace dat.
SYNTAX
ByName (výchozí)
New-CMCollection -CollectionType <CollectionType> [-Comment <String>] -LimitingCollectionName <String>
-Name <String> [-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>]
[-VariablePriority <Int32>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
ByValue
New-CMCollection -CollectionType <CollectionType> [-Comment <String>] -InputObject <IResultObject>
-Name <String> [-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>]
[-VariablePriority <Int32>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
ById
New-CMCollection -CollectionType <CollectionType> [-Comment <String>] -LimitingCollectionId <String>
-Name <String> [-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>]
[-VariablePriority <Int32>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
DESCRIPTION
Rutina New-CMCollection vytvoří kolekci v Správce konfigurace.
Správce konfigurace kolekce poskytují způsob, jak spravovat uživatele, počítače a další prostředky ve vaší organizaci. Nejenže vám poskytují způsob uspořádání prostředků, ale také vám poskytují způsob distribuce balíčků Správce konfigurace klientům a uživatelům.
Poznámka
Spusťte Správce konfigurace rutiny z Správce konfigurace lokality, například PS XYZ:\>
. Další informace najdete v tématu Začínáme.
EXAMPLES
Příklad 1: Vytvoření kolekce a určení jejího oboru
PS XYZ:\> New-CMCollection -CollectionType User -LimitingCollectionName "All Users" -Name "testUser"
Tento příkaz vytvoří kolekci uživatelů s názvem testUser, která vytvoří kolekci Všichni uživatelé jako obor, ze kterého můžete přidávat členy.
Příklad 2: Vytvoření kolekce na základě existující kolekce
PS XYZ:\> Get-CMCollection -Name "All Users" | New-CMCollection -Name "testUser" -CollectionType "User"
Tento příkaz získá objekt kolekce s názvem Všichni uživatelé a pomocí operátoru kanálu předá objekt do new-CMCollection. New-CMCollection vytvoří kolekci s názvem testUser, která je založená na členství v kolekci Všichni uživatelé.
PARAMETERS
-CollectionType
Určuje typ kolekce. Platné hodnoty jsou:
- Kořenová složka
- Uživatel
- Zařízení
- Neznámý
Type: CollectionType
Parameter Sets: (All)
Aliases:
Accepted values: User, Device
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Comment
Určuje komentář pro kolekci.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Tento parametr považuje zástupné znaky za hodnoty literálových znaků. Nemůžete ho 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čuje se). Nemůžete ho kombinovat s příkazem DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Určuje objekt kolekce, který se má použít jako obor pro tuto kolekci. K získání objektu kolekce použijte rutinu Get-CMCollection.
Type: IResultObject
Parameter Sets: ByValue
Aliases: LimitingCollection
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-LimitingCollectionId
Určuje ID kolekce, která se má použít jako obor pro tuto kolekci.
Type: String
Parameter Sets: ById
Aliases: LimitToCollectionId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-LimitingCollectionName
Určuje název kolekce, která se má použít jako obor pro tuto kolekci.
Type: String
Parameter Sets: ByName
Aliases: LimitToCollectionName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Určuje název kolekce.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RefreshSchedule
Určuje plán, který určuje, kdy Správce konfigurace aktualizuje kolekci.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RefreshType
Určuje, Správce konfigurace kolekce aktualizuje. Platné hodnoty jsou:
- Žádná
- Ruční
- Pravidelné
- Průběžný
- Obojí
Type: CollectionRefreshType
Parameter Sets: (All)
Aliases:
Accepted values: None, Manual, Periodic, Continuous, Both
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-VariablePriority
{{ Fill VariablePriority Description }}
Type: Int32
Parameter Sets: (All)
Aliases: DeviceCollectionVariablePrecedence
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespouštěl.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
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.