Set-CMDeviceCollectionVariable
SYNOPSIS
Ustawia zmienną kolekcji urządzeń.
SYNTAX
SetByValueMandatory (ustawienie domyślne)
Set-CMDeviceCollectionVariable -InputObject <IResultObject> [-IsMask <Boolean>] [-NewVariableName <String>]
[-NewVariableValue <String>] -VariableName <String> [-DisableWildcardHandling] [-ForceWildcardHandling]
[-WhatIf] [-Confirm] [<CommonParameters>]
SetByIdMandatory
Set-CMDeviceCollectionVariable -CollectionId <String> [-IsMask <Boolean>] [-NewVariableName <String>]
[-NewVariableValue <String>] -VariableName <String> [-DisableWildcardHandling] [-ForceWildcardHandling]
[-WhatIf] [-Confirm] [<CommonParameters>]
SetByNameMandatory
Set-CMDeviceCollectionVariable -CollectionName <String> [-IsMask <Boolean>] [-NewVariableName <String>]
[-NewVariableValue <String>] -VariableName <String> [-DisableWildcardHandling] [-ForceWildcardHandling]
[-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Polecenie cmdlet Set-CMDeviceCollectionVariable zmienia ustawienia zmiennej kolekcji urządzeń.
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: zmiana nazwy zmiennej
PS XYZ:\> $Collection = Get-CMCollection -Name "Device"
PS XYZ:\> Set-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -NewVariableName "NewVariable"
Pierwsze polecenie pobiera obiekt kolekcji urządzeń o nazwie Device i zapisuje obiekt w $Collection zmiennej.
Drugie polecenie zmienia nazwę zmiennej kolekcji testTS dla kolekcji urządzeń przechowywanej w programie $Collection na NewVariable.
Przykład 2. Zmienianie nazwy zmiennej przy użyciu potoku
PS XYZ:\> Get-CMCollection -Name "Device" | Set-CMDeviceCollectionVariable -VariableName "testTS" -NewVariableName "NewVariable"
To polecenie pobiera obiekt kolekcji urządzeń o nazwie Device i używa operatora potoku do przekazania obiektu do polecenia Set-CMDeviceCollectionVariable, co zmienia nazwę zmiennej kolekcji testTS dla obiektu kolekcji urządzeń na NewVariable.
PARAMETERS
-CollectionId
Określa identyfikator kolekcji urządzeń.
Type: String
Parameter Sets: SetByIdMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName (Nazwa kolekcji)
Określa nazwę kolekcji urządzeń.
Type: String
Parameter Sets: SetByNameMandatory
Aliases:
Required: True
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 urządzeń. Aby uzyskać obiekt kolekcji, użyj polecenia cmdlet Get-CMCollection.
Type: IResultObject
Parameter Sets: SetByValueMandatory
Aliases: Collection
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-IsMask
Wskazuje, czy wartość zmiennej kolekcji jest wyświetlana w Menedżer konfiguracji konsoli.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewVariableName
Określa nową nazwę zmiennej kolekcji.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewVariableValue
Określa nową wartość zmiennej kolekcji.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-VariableName
Określa nazwę zmiennej kolekcji.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
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.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
System.Object
UWAGI
RELATED LINKS
Planowanie strategii sekwencji zadań w programie Menedżer konfiguracji
Get-CMDeviceCollectionVariable
New-CMDeviceCollectionVariable