Set-CMCollection
SYNOPSIS
Ustawia Menedżer konfiguracji kolekcji.
SYNTAX
SetByValue (wartość domyślna)
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
Polecenie cmdlet Set-CMCollection zmienia ustawienia kolekcji w Menedżer konfiguracji.
Menedżer konfiguracji kolekcje zapewniają sposób zarządzania użytkownikami, komputerami i innymi zasobami w organizacji. Zapewniają one nie tylko sposób organizowania zasobów, ale także sposób dystrybucji pakietów Menedżer konfiguracji klientom i użytkownikom.
Uwaga
Uruchom Menedżer konfiguracji cmdlet z Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.
EXAMPLES
Przykład 1: pobieranie i modyfikowanie kolekcji
PS XYZ:\> $userCollection = Get-CMCollection -Name "testUser"
PS XYZ:\> Set-CMCollection -CollectionId $userCollection -NewName "newTestUser"
Pierwsze polecenie pobiera obiekt kolekcji o nazwie testUser i przechowuje obiekt w $userCollection zmiennej.
Drugie polecenie aktualizuje nazwę kolekcji w $userCollection.
Przykład 2: przekaż kolekcję i zmodyfikuj ją
PS XYZ:\> Get-CMCollection -Name "testUser" | Set-CMCollection -NewName "newTestUser"
To polecenie pobiera obiekt kolekcji o nazwie testUser i używa operatora potoku do przekazania obiektu do polecenia Set-CMCollection, które aktualizuje jego nazwę na newTestUser.
PARAMETERS
-CollectionId
Określa identyfikator kolekcji.
Type: String
Parameter Sets: SetById
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Komentarz
Określa komentarz dla kolekcji.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Ten parametr traktuje symbole wieloznaczne jako wartości literału znaków. Nie można połączyć go z forceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Określa obiekt kolekcji. Aby uzyskać obiekt kolekcji, użyj polecenia cmdlet 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
Określa obiekt kolekcji do użycia jako zakres dla tej kolekcji. Aby uzyskać obiekt kolekcji, użyj polecenia cmdlet Get-CMCollection.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-LimitingCollectionId
Określa identyfikator kolekcji do użycia jako zakres dla tej kolekcji.
Type: String
Parameter Sets: (All)
Aliases: LimitToCollectionId
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-LimitingCollectionName
Określa nazwę kolekcji do użycia jako zakres dla tej kolekcji.
Type: String
Parameter Sets: (All)
Aliases: LimitToCollectionName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Określa nazwę kolekcji.
Type: String
Parameter Sets: SetByName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewName
Określa nową nazwę kolekcji.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Dodaj ten parametr, aby zwrócić obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet może nie generować żadnych danych wyjściowych.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RefreshSchedule (Harmonogram odświeżania)
Określa harmonogram, który określa, Menedżer konfiguracji odświeża kolekcji.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RefreshType
Określa sposób Menedżer konfiguracji odświeżania kolekcji. Prawidłowe wartości:
- Brak
- Ręcznie
- Okresowe
- Ciągłe
- Oba
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
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
Typowe parametry
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.