Set-CMCollection
SYNOPSIS
Anger en Konfigurationshanteraren samling.
SYNTAX
SetByValue (standard)
Set-CMCollection [-Comment <String>] -InputObject <IResultObject> [-LimitingCollection <IResultObject>]
[-LimitingCollectionId <String>] [-LimitingCollectionName <String>] [-NewName <String>] [-PassThru]
[-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>] [-VariablePriority <Int32>]
[-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SetById
Set-CMCollection -CollectionId <String> [-Comment <String>] [-LimitingCollection <IResultObject>]
[-LimitingCollectionId <String>] [-LimitingCollectionName <String>] [-NewName <String>] [-PassThru]
[-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>] [-VariablePriority <Int32>]
[-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SetByName
Set-CMCollection [-Comment <String>] [-LimitingCollection <IResultObject>] [-LimitingCollectionId <String>]
[-LimitingCollectionName <String>] -Name <String> [-NewName <String>] [-PassThru]
[-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>] [-VariablePriority <Int32>]
[-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Cmdleten Set-CMCollection ändrar inställningarna för 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 platsenhet, till exempel PS XYZ:\> . Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Hämta en samling och ändra den
PS XYZ:\> $userCollection = Get-CMCollection -Name "testUser"
PS XYZ:\> Set-CMCollection -CollectionId $userCollection -NewName "newTestUser"
Det första kommandot hämtar samlingsobjektet med namnet testUser och lagrar objektet i $userCollection variabeln.
Det andra kommandot uppdaterar namnet på samlingen i $userCollection.
Exempel 2: Skicka en samling och ändra den
PS XYZ:\> Get-CMCollection -Name "testUser" | Set-CMCollection -NewName "newTestUser"
Det här kommandot hämtar samlingsobjektet med namnet testUser och använder pipelineoperatorn för att skicka objektet till Set-CMCollection, som uppdaterar dess namn till newTestUser.
PARAMETERS
-CollectionId
Anger ett samlings-ID.
Type: String
Parameter Sets: SetById
Aliases:
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. Om du vill hämta ett samlingsobjekt använder du cmdleten Get-CMCollection.
Type: IResultObject
Parameter Sets: SetByValue
Aliases: Collection
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-LimitingCollection
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: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
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: (All)
Aliases: LimitToCollectionId
Required: False
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: (All)
Aliases: LimitToCollectionName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Anger namnet på en samling.
Type: String
Parameter Sets: SetByName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewName
Anger ett nytt namn för samlingen.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Lägg till den här parametern för att returnera ett objekt som representerar det objekt som du arbetar med. Som standard genererar denna cmdlet kanske inte några utdata.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RefreshSchedule
Anger ett schema som avgö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.