Sdílet prostřednictvím


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.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_Collection

POZNÁMKY

Export CMCollection

Get-CMCollection

Import CMCollection

Remove-CMCollection

Set-CMCollection