Dela via

New-CMDeviceCollectionVariable

  • Artikel

SYNOPSIS

Skapar en enhetssamlingsvariabel.

SYNTAX

NewByValueMandatory (standard)

New-CMDeviceCollectionVariable -InputObject <IResultObject> [-IsMask <Boolean>] [-Value <String>]
 -VariableName <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

NewByIdMandatory

New-CMDeviceCollectionVariable -CollectionId <String> [-IsMask <Boolean>] [-Value <String>]
 -VariableName <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

NewByNameMandatory

New-CMDeviceCollectionVariable -CollectionName <String> [-IsMask <Boolean>] [-Value <String>]
 -VariableName <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

DESCRIPTION

Cmdleten New-CMDeviceCollectionVariable skapar en variabel för enhetssamlingen. Du kan använda en enhetssamlingsvariabel för att definiera anpassade aktivitetssekvensvariabler och deras associerade värden som ska användas av resurserna i en samling. Aktivitetssekvensvariabler är en uppsättning namn- och värdepar som tillhandahåller en mekanism för att konfigurera och anpassa stegen i en aktivitetssekvens när aktivitetssekvensen distribueras till en specifik samling.

Anteckning

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

EXAMPLES

Exempel 1: Skapa en enhetssamlingsvariabel

PS XYZ:\> $Collection = Get-CMCollection -Name "Device"
PS XYZ:\> New-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -Value "test001"

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

Det andra kommandot skapar en samlingsvariabel med namnet testTS med värdet test001 för samlingsobjektet som lagras i $Collection.

PARAMETERS

-CollectionId

Anger ID för en enhetssamling.

Type: String
Parameter Sets: NewByIdMandatory
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: NewByNameMandatory
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: NewByValueMandatory
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

-Value

Anger ett värde för samlingsvariabeln.

Type: String
Parameter Sets: (All)
Aliases: VariableValue

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

-VariableName

Anger ett namn för samlingsvariabeln.

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

IResultObject[]#SMS_CollectionSettings

IResultObject#SMS_CollectionSettings

ANTECKNINGAR

Planera en aktivitetssekvensstrategi i Konfigurationshanteraren

Get-CMCollection

Get-CMDeviceCollectionVariable

Set-CMDeviceCollectionVariable

Remove-CMDeviceCollectionVariable

Get-CMUserCollection