Udostępnij za pośrednictwem

New-CMDeviceCollectionVariable

  • Artykuł

SYNOPSIS

Tworzy zmienną kolekcji urządzeń.

SYNTAX

NewByValueMandatory (ustawienie domyślne)

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

Polecenie cmdlet New-CMDeviceCollectionVariable tworzy zmienną kolekcji urządzeń. Zmiennej kolekcji urządzeń można użyć do zdefiniowania niestandardowych zmiennych sekwencji zadań i skojarzonych z nimi wartości do użycia przez zasoby w kolekcji. Zmienne sekwencji zadań to zestaw par nazw i wartości, które zapewniają mechanizm konfigurowania i dostosowywania kroków sekwencji zadań podczas wdrażania sekwencji zadań w określonej kolekcji.

Uwaga

Uruchom Menedżer konfiguracji cmdlet z Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.

EXAMPLES

Przykład 1: Tworzenie zmiennej kolekcji urządzeń

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

Pierwsze polecenie pobiera obiekt kolekcji urządzeń o nazwie Device i zapisuje obiekt w $Collection zmiennej.

Drugie polecenie tworzy zmienną kolekcji o nazwie testTS o wartości test001 dla obiektu kolekcji przechowywanego w $Collection.

PARAMETERS

-CollectionId

Określa identyfikator kolekcji urządzeń.

Type: String
Parameter Sets: NewByIdMandatory
Aliases:

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

-CollectionName (Nazwa kolekcji)

Określa nazwę kolekcji urządzeń.

Type: String
Parameter Sets: NewByNameMandatory
Aliases:

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

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

-DisableWildcardHandling

Ten parametr traktuje symbole wieloznaczne jako wartości literału znaków. Nie można połączyć go z forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

Określa obiekt kolekcji urządzeń. Aby uzyskać obiekt kolekcji, użyj polecenia cmdlet 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

Wskazuje, czy wartość zmiennej kolekcji jest wyświetlana w Menedżer konfiguracji konsoli.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Value (Wartość)

Określa wartość zmiennej kolekcji.

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

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

-VariableName

Określa nazwę zmiennej kolekcji.

Type: String
Parameter Sets: (All)
Aliases:

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

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

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject[]#SMS_CollectionSettings

IResultObject#SMS_CollectionSettings

UWAGI

Planowanie strategii sekwencji zadań w programie Menedżer konfiguracji

Get-CMCollection

Get-CMDeviceCollectionVariable

Set-CMDeviceCollectionVariable

Remove-CMDeviceCollectionVariable

Get-CMUserCollection