Sdílet prostřednictvím

Remove-CMDeviceCollectionVariable

  • Článek

SYNOPSIS

Odebere proměnnou kolekce zařízení.

SYNTAX

SearchByValueMandatory (výchozí)

Remove-CMDeviceCollectionVariable -Collection <IResultObject> [-Force] -VariableName <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByIdMandatory

Remove-CMDeviceCollectionVariable -CollectionId <String> [-Force] -VariableName <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByNameMandatory

Remove-CMDeviceCollectionVariable -CollectionName <String> [-Force] -VariableName <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Rutina Remove-CMDeviceCollectionVariable odebere proměnnou kolekce zařízení.

Poznámka

Spusťte Správce konfigurace rutiny z Správce konfigurace lokality, například PS XYZ:\> . Další informace najdete v tématu Začínáme.

EXAMPLES

Příklad 1: Odebrání proměnné kolekce zařízení

PS XYZ:\> $Collection = Get-CMCollection -Name "Device"
PS XYZ:\> Remove-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -Force

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

Druhý příkaz odebere proměnnou kolekce zařízení testTS z kolekce zařízení uložené v $Collection. Zadání parametru Force indikuje, že uživatel před odebráním proměnné není vyzván.

Příklad 2: Odebrání proměnné kolekce zařízení pomocí kanálu

PS XYZ:\> Get-CMCollection -Name "Device" | Remove-CMDeviceCollectionVariable -VariableName "testTS" -Force

Tento příkaz získá objekt kolekce zařízení s názvem Device a pomocí operátoru kanálu předá objekt do remove-CMDeviceCollectionVariable, která z objektu kolekce zařízení odebere proměnnou kolekce zařízení testTS. Zadání parametru Force indikuje, že uživatel před odebráním proměnné není vyzván.

PARAMETERS

-Collection

Určuje objekt kolekce zařízení. K získání objektu kolekce použijte rutinu Get-CMCollection.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

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

-CollectionId

Určuje ID kolekce zařízení.

Type: String
Parameter Sets: SearchByIdMandatory
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: SearchByNameMandatory
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 za hodnoty literálových znaků. Nemůžete ho kombinovat s forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Force

Vynutí spuštění příkazu bez předchozího potvrzení uživatele.

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čuje se). Nemůžete ho kombinovat s příkazem DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-VariableName

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 nespouštěl.

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

Get-CMCollection

Get-CMDeviceCollectionVariable

Set-CMDeviceCollectionVariable

New-CMDeviceCollectionVariable