Sdílet prostřednictvím


New-CMDeviceCollectionVariable

SYNOPSIS

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

SYNTAX

NewByValueMandatory (výchozí)

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

Rutina New-CMDeviceCollectionVariable vytvoří proměnnou kolekce zařízení. Pomocí proměnné kolekce zařízení můžete definovat vlastní proměnné pořadí úkolů a jejich přidružené hodnoty, které mají být použity prostředky v kolekci. Proměnné pořadí úkolů jsou sada dvojic názvů a hodnot, které poskytují mechanismus konfigurace a přizpůsobení kroků pořadí úkolů při nasazení pořadí úkolů do určité kolekce.

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: Vytvoření proměnné kolekce zařízení

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

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

Druhý příkaz vytvoří proměnnou kolekce s názvem testTS s hodnotou test001 pro objekt kolekce, který je uložen v $Collection.

PARAMETERS

-CollectionId

Určuje ID kolekce zařízení.

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

-Value

Určuje hodnotu pro proměnnou kolekce.

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

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

IResultObject [] #SMS_CollectionSettings

IResultObject # SMS_CollectionSettings

POZNÁMKY

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

Get-CMCollection

Get-CMDeviceCollectionVariable

Set-CMDeviceCollectionVariable

Remove-CMDeviceCollectionVariable

Get-CMUserCollection