Udostępnij za pośrednictwem

New-CMTSRule

  • Artykuł

SYNOPSIS

Utwórz regułę, aby dodać ją do kroku sekwencji zadań Ustaw zmienne dynamiczne.

SYNTAX

VariableOnly (wartość domyślna)

New-CMTSRule -Variable <Hashtable> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

ComputerCondition

New-CMTSRule [-AssetTag <String>] [-MacAddress <String>] [-SerialNumber <String>] [-Uuid <String>]
 -Variable <Hashtable> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

LocationCondition

New-CMTSRule [-DefaultGateway <String>] -Variable <Hashtable> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

MakeModelCondition

New-CMTSRule [-Make <String>] [-Model <String>] -Variable <Hashtable> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

VariableCondition

New-CMTSRule [-ReferencedVariableName <String>] [-ReferencedVariableOperator <VariableOperatorType>]
 [-ReferencedVariableValue <String>] -Variable <Hashtable> [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

To polecenie cmdlet umożliwia utworzenie reguły, która można dodać do kroku sekwencji zadań Ustaw zmienne dynamiczne. Gdy sekwencja zadań uruchamia ten krok, ocenia reguły dynamiczne i zmienne w określonej kolejności. Podczas oceniania reguł na określonym urządzeniu można ustawić zmienne sekwencji zadań na podstawie tych reguł.

Istnieją cztery typy reguł:

  • Komputer: Oceń wartości tagu zasobu sprzętu, UUID, numeru seryjnego lub adresu MAC.
  • Lokalizacja: Oceń wartości domyślnej bramy sieci.
  • Make i Model: oceń wartości marki i modelu komputera.
  • Zmienna sekwencji zadań: dodaj zmienną sekwencji zadań, warunek i wartość do oceny.

Aby uzyskać więcej informacji, zobacz Reguły dynamiczne i zmienne.

Uwaga

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

EXAMPLES

Przykład 1: ustawienie miejsca docelowego pobierania, jeśli jest w Windows PE

Ten przykład tworzy następującą regułę:

IF _SMSTSInWinPE equals "TRUE" THEN SET OSDDownloadDestinationLocationType = "TSCache"

Następnie dodaje tę regułę do istniejącego wystąpienia tego kroku w sekwencji zadań.

$tsrule = New-CMTSRule -Variable @{'OSDDownloadDestinationLocationType' = 'TSCache'} -ReferencedVariableName "_SMSTSInWinPE" -ReferencedVariableOperator equals -ReferencedVariableValue TRUE

$tsname = "Default IPU"
$tsstep = "Set Dynamic Variables"

Set-CMTSStepSetDynamicVariable -TaskSequenceName $tsname -StepName $tsstep -AddRule $tsrule

PARAMETERS

-AssetTag

Określ tag zasobu dla typu reguły Komputer. Maksymalna wartość to 255 znaków.

Jeśli na przykład ustawisz tę wartość na 123456 , zostanie dodana następująca reguła: IF Asset tag equals "123456" THEN

Type: String
Parameter Sets: ComputerCondition
Aliases:

Required: False
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: None
Accept pipeline input: False
Accept wildcard characters: False

-DefaultGateway

Określ bramę domyślną dla typu reguły Lokalizacja.

Jeśli na przykład ustawisz tę wartość na 192.168.10.1 , zostanie dodana następująca reguła: IF Default gateway equals "192.168.10.1" THEN

Type: String
Parameter Sets: LocationCondition
Aliases:

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

-DisableWildcardHandling

Ten parametr traktuje symbole wieloznaczne jako wartości znaków literału. 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

-MacAddress

Określ adres MAC dla typu reguły Komputer.

Jeśli na przykład ustawisz tę wartość na 00:11:22:33:44:55 , zostanie dodana następująca reguła: IF MAC address equals "00:11:22:33:44:55" THEN

Type: String
Parameter Sets: ComputerCondition
Aliases:

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

-Make

Określ typ reguły Make (Make) i Model (Model). Aby ustawić drugą wartość, użyj parametru Model. Reguła ma wartość true, gdy obie wartości mają wartość true.

Można używać symboli wieloznacznych:

  • *: wiele znaków
  • ?: pojedynczy znak

Jeśli na przykład ustawisz tę wartość na , Surface a model na , * zostanie dodana następująca reguła: IF Make equals "Surface" AND Model equals "*" THEN

Type: String
Parameter Sets: MakeModelCondition
Aliases:

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

-Model (Model)

Określ model dla typu reguł Make i Model. Aby ustawić inną wartość, użyj parametru Make. Reguła ma wartość true, gdy obie wartości mają wartość true.

Można używać symboli wieloznacznych:

  • *: wiele znaków
  • ?: pojedynczy znak

Jeśli na przykład ustawisz tę wartość na i ustawisz wartość * na , zostanie Surface dodana następująca reguła:IF Make equals "Surface" AND Model equals "*" THEN

Type: String
Parameter Sets: MakeModelCondition
Aliases:

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

-ReferencedVariableName

Określ zmienną dla typu reguły Zmienna sekwencji zadań. Wymagane jest również ustawienie parametrów ReferencedVariableOperator i ReferencedVariableValue.

Ta nazwa zmiennej może być wbudowaną zmienną sekwencji zadań lub niestandardową, która została utworzona. Aby uzyskać więcej informacji, zobacz Jak używać zmiennych sekwencji zadań w programie Menedżer konfiguracji.

Jeśli na przykład ustawisz następujące wartości:

  • ReferencedVariableName: OSDRegisteredOrgName
  • ReferencedVariableOperator: Equals
  • ReferencedVariableValue: Contoso

Następnie dodaje następującą regułę: IF OSDRegisteredOrgName equals "Contoso" THEN

Type: String
Parameter Sets: VariableCondition
Aliases:

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

-ReferencedVariableOperator

Określ warunek dla typu reguły Zmienna sekwencji zadań. Wymaga również ustawienia parametrów ReferencedVariableName i ReferencedVariableValue. Aby uzyskać informacje na temat dostępnych operatorów, zobacz listę akceptowanych wartości dla tego parametru.

Jeśli na przykład ustawisz następujące wartości:

  • ReferencedVariableName: OSDRegisteredOrgName
  • ReferencedVariableOperator: Equals
  • ReferencedVariableValue: Contoso

Następnie dodaje następującą regułę: IF OSDRegisteredOrgName equals "Contoso" THEN

Type: VariableOperatorType
Parameter Sets: VariableCondition
Aliases:
Accepted values: Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual, Like, NotLike

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

-ReferencedVariableValue

Określ wartość dla typu reguły Zmienna sekwencji zadań. Wymagane jest również ustawienie parametrów ReferencedVariableName i ReferencedVariableOperator.

Jeśli na przykład ustawisz następujące wartości:

  • ReferencedVariableName: OSDRegisteredOrgName
  • ReferencedVariableOperator: Equals
  • ReferencedVariableValue: Contoso

Następnie dodaje następującą regułę: IF OSDRegisteredOrgName equals "Contoso" THEN

Type: String
Parameter Sets: VariableCondition
Aliases:

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

-SerialNumber

Określ numer seryjny dla typu reguły Komputer.

Jeśli na przykład ustawisz tę wartość na 123456 , zostanie dodana następująca reguła: IF Asset tag equals "123456" THEN

Type: String
Parameter Sets: ComputerCondition
Aliases:

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

-Uuid

Określ wartość UUID dla typu reguły Komputer.

Jeśli na przykład ustawisz tę wartość na de5ba380-f692-45e0-bbd3-0e40543b549e , zostanie dodana następująca reguła: IF UUID equals "de5ba380-f692-45e0-bbd3-0e40543b549e" THEN

Type: String
Parameter Sets: ComputerCondition
Aliases:

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

-Variable

Określ istniejące lub niestandardowe zmienne sekwencji zadań i skojarzone wartości, które krok powinien ustawić, gdy reguła ma wartość true.

Jeśli na przykład ustawisz tę wartość na wartość , po właściwości reguły zostanie @{'OSDDownloadDestinationLocationType' = 'TSCache'} THEN dodana następująca zmienna: SET OSDDownloadDestinationLocationType = "TSCache"

Aby określić więcej niż jedną zmienną w tej samej tabeli skrótów, użyj ogranicznika ; średnika (). Na przykład: @{'OSDRegisteredUserName' = 'Contoso';'OSDRegisteredOrgName' = 'Contoso'}

Type: Hashtable
Parameter Sets: (All)
Aliases: Variables

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: None
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

Brak

OUTPUTS

IResultObject#SMS_TaskSequence_Rule

UWAGI

Set-CMTSStepSetDynamicVariable

New-CMTSStepSetDynamicVariable

Informacje o krokach sekwencji zadań — ustawianie zmiennych dynamicznych

Jak używać zmiennych sekwencji zadań w programie Menedżer konfiguracji