Delen via

Set-CMDeviceCollectionVariable

  • Artikel

SYNOPSIS

Hiermee stelt u een variabele voor de apparaatverzameling in.

SYNTAX

SetByValueMandatory (standaard)

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

Met de cmdlet Set-CMDeviceCollectionVariable worden de instellingen van een apparaatverzamelingsvariabele gewijzigd.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: de naam van een variabele wijzigen

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

Met de eerste opdracht wordt het apparaatverzamelingsobject met de naam Apparaat ophaald en wordt het object op de $Collection op slaat.

Met de tweede opdracht wordt de naam van de verzamelingsvariabele testTS voor de apparaatverzameling die is opgeslagen in $Collection gewijzigd in NewVariable.

Voorbeeld 2: de naam van een variabele wijzigen met behulp van de pijplijn

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

Met deze opdracht wordt het apparaatverzamelingsobject met de naam Apparaat opgeslagen en wordt de pijplijnoperator gebruikt om het object door te geven aan Set-CMDeviceCollectionVariable, waarmee de naam van de verzamelingsvariabele testTS voor het apparaatverzamelingsobject wordt gewijzigd in NewVariable.

PARAMETERS

-CollectionId

Hiermee geeft u de id van een apparaatverzameling op.

Type: String
Parameter Sets: SetByIdMandatory
Aliases:

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

-CollectionName

Hiermee geeft u de naam van een apparaatverzameling op.

Type: String
Parameter Sets: SetByNameMandatory
Aliases:

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

Hiermee geeft u een apparaatverzamelingsobject op. Als u een verzamelingsobject wilt ophalen, gebruikt u de 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

Geeft aan of de waarde van de verzamelingsvariabele wordt weergegeven in Configuration Manager console.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-NewVariableName

Hiermee geeft u een nieuwe naam op voor de verzamelingsvariabele.

Type: String
Parameter Sets: (All)
Aliases:

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

-NewVariableValue

Hiermee geeft u een nieuwe waarde op voor de verzamelingsvariabele.

Type: String
Parameter Sets: (All)
Aliases:

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

-VariableName

Hiermee geeft u de naam van een verzamelingsvariabele op.

Type: String
Parameter Sets: (All)
Aliases:

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

OPMERKINGEN

Een takenreeksstrategie plannen in Configuration Manager

Get-CMDeviceCollectionVariable

Get-CMCollection

New-CMDeviceCollectionVariable

Remove-CMDeviceCollectionVariable

Get-CMDeviceCollection