Sdílet prostřednictvím

Set-CMDeviceCollectionVariable

  • Článek

SYNOPSIS

Nastaví proměnnou kolekce zařízení.

SYNTAX

SetByValueMandatory (výchozí)

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

Rutina set-CMDeviceCollectionVariable změní nastavení proměnné kolekce zařízení.

Poznámka

Použijte například rutiny Configuration Manager z Configuration Manager jednotky webu PS XYZ:\> . Další informace najdete v tématu Začínáme.

EXAMPLES

Příklad 1: Změna názvu proměnné

PS XYZ:\> $Collection = Get-CMCollection -Name "Device"
PS XYZ:\> Set-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -NewVariableName "NewVariable"

První příkaz načte objekt kolekce zařízení s názvem Device a uloží objekt do proměnné $Collection.

Druhý příkaz změní název proměnné kolekce testTS pro kolekci zařízení uloženou v $Collection na NewVariable.

Příklad 2: Změna názvu proměnné pomocí kanálu

PS XYZ:\> Get-CMCollection -Name "Device" | Set-CMDeviceCollectionVariable -VariableName "testTS" -NewVariableName "NewVariable"

Tento příkaz načte objekt kolekce zařízení s názvem Device a pomocí operátoru kanálu předáte objektu set-CMDeviceCollectionVariable, který změní název proměnné kolekce testTS pro objekt kolekce zařízení na NewVariable.

PARAMETERS

-CollectionId

Určuje ID kolekce zařízení.

Type: String
Parameter Sets: SetByIdMandatory
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CollectionName

Určuje název kolekce zařízení.

Type: String
Parameter Sets: SetByNameMandatory
Aliases:

Required: True
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 jako literálové hodnoty znaků. Nejde 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čujeme). Nejde kombinovat s DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

– Položky InputObject

Určuje objekt kolekce zařízení. Chcete-li získat objekt kolekce, použijte rutinu 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

-Maska

Označuje, zda se hodnota proměnné kolekce zobrazí v konzole Configuration Manager.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-NewVariableName

Určuje nový název proměnné kolekce.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-NewVariableValue

Určuje novou hodnotu pro proměnnou kolekce.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Variable

Určuje název proměnné kolekce.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
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 nespustí.

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

System.Object

POZNÁMKY

Plánování strategie pořadí úloh v Configuration Manager

Get-CMDeviceCollectionVariable

Get-CMCollection

New-CMDeviceCollectionVariable

Remove-CMDeviceCollectionVariable

Get-CMDeviceCollection