Dela via


Set-CMDeviceCollectionVariable

SYNOPSIS

Anger en variabel för enhetssamling.

SYNTAX

SetByValueMandatory (standard)

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

Cmdleten Set-CMDeviceCollectionVariable ändrar inställningarna för en enhetssamlingsvariabel.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Ändra ett variabelnamn

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

Det första kommandot hämtar enhetssamlingsobjektet med namnet Device och lagrar objektet i $Collection variabeln.

Det andra kommandot ändrar namnet på samlingsvariabeln testTS för enhetssamlingen som lagras i $Collection till NewVariable.

Exempel 2: Ändra ett variabelnamn med hjälp av pipelinen

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

Det här kommandot hämtar enhetssamlingsobjektet med namnet Device och använder pipelineoperatorn för att skicka objektet till Set-CMDeviceCollectionVariable, vilket ändrar namnet på samlingsvariabeln testTS för enhetssamlingsobjektet till NewVariable.

PARAMETERS

-CollectionId

Anger ID för en enhetssamling.

Type: String
Parameter Sets: SetByIdMandatory
Aliases:

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

-CollectionName

Anger namnet på en enhetssamling.

Type: String
Parameter Sets: SetByNameMandatory
Aliases:

Required: True
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 enhetssamlingsobjekt. Om du vill hämta ett samlingsobjekt använder du cmdleten 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

Anger om samlingsvariabelvärdet visas i Konfigurationshanteraren konsolen.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-NewVariableName

Anger ett nytt namn för samlingsvariabeln.

Type: String
Parameter Sets: (All)
Aliases:

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

-NewVariableValue

Anger ett nytt värde för samlingsvariabeln.

Type: String
Parameter Sets: (All)
Aliases:

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

-VariableName

Anger namnet på en samlingsvariabel.

Type: String
Parameter Sets: (All)
Aliases:

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

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

ANTECKNINGAR

Planera en aktivitetssekvensstrategi i Konfigurationshanteraren

Get-CMDeviceCollectionVariable

Get-CMCollection

New-CMDeviceCollectionVariable

Remove-CMDeviceCollectionVariable

Get-CMDeviceCollection