New-CMCollection
SYNOPSIS
Skapar en Konfigurationshanteraren samling.
SYNTAX
ByName (standard)
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
Cmdleten New-CMCollection skapar en samling i Konfigurationshanteraren.
Konfigurationshanteraren samlingar är ett sätt att hantera användare, datorer och andra resurser i din organisation. De ger dig inte bara möjlighet att organisera dina resurser, utan ger dig också möjlighet att distribuera Konfigurationshanteraren paket till klienter och användare.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Skapa en samling och ange dess omfång
PS XYZ:\> New-CMCollection -CollectionType User -LimitingCollectionName "All Users" -Name "testUser"
Det här kommandot skapar en användarsamling med namnet testUser som upprättar samlingen Alla användare som det omfång som du kan lägga till medlemmar från.
Exempel 2: Skapa en samling baserat på en befintlig
PS XYZ:\> Get-CMCollection -Name "All Users" | New-CMCollection -Name "testUser" -CollectionType "User"
Det här kommandot hämtar samlingsobjektet med namnet Alla användare och använder pipelineoperatorn för att skicka objektet till New-CMCollection. New-CMCollection skapar en samling med namnet testUser som baseras på medlemskapet i samlingen Alla användare.
PARAMETERS
-CollectionType
Anger en typ för samlingen. Giltiga värden är:
- Rot
- Användare
- Enhet
- Okänt
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
-Kommentar
Anger en kommentar för samlingen.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
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
Anger ett samlingsobjekt som ska användas som omfång för den här samlingen. Om du vill hämta ett samlingsobjekt använder du cmdleten 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
Anger ID för en samling som ska användas som omfång för den här samlingen.
Type: String
Parameter Sets: ById
Aliases: LimitToCollectionId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-LimitingCollectionName
Anger namnet på en samling som ska användas som omfång för den här samlingen.
Type: String
Parameter Sets: ByName
Aliases: LimitToCollectionName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Anger ett namn för samlingen.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RefreshSchedule
Anger ett schema som avgör när Konfigurationshanteraren uppdaterar samlingen.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RefreshType
Anger hur Konfigurationshanteraren uppdaterar samlingen. Giltiga värden är:
- Ingen
- Manuell
- Periodiska
- Kontinuerlig igenkänning
- Båda
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
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
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.