max

Synopsis

Returnerar det maximala värdet från en uppsättning heltal.

Syntax

max(<integerList>)

Description

Funktionen max() returnerar det maximala värdet från en matris med heltal eller en kommaavgränsad lista med heltal.

Exempel

Exempel 1 – Returnera maximum från en kommaavgränsad lista med heltal

Den här konfigurationen returnerar det största talet från en lista med heltal.

# max.example.1.dsc.config.yaml
$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
resources:
- name: Echo maximum value
  type: Test/Echo
  properties:
    output: "[max(3, 2, 5, 1, 7)]"

dsc config get --document max.example.1.dsc.config.yaml config get

results:
- name: Echo maximum value
  type: Test/Echo
  result:
    actualState:
      output: 7
messages: []
hadErrors: false

Exempel 2 – Returnera maximum från en matris med heltal

Den här konfigurationen returnerar det största antalet från en matris med heltal som hämtas som en referens till en annan resursinstans. Den använder YAML:s vikta flerradssyntax för att göra funktionen mer läsbar.

# max.example.2.dsc.config.yaml
$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
resources:
- name: Echo integer array
  type: Test/Echo
  properties:
    output:
    - 3
    - 2
    - 5
    - 1
    - 7
- name: Echo maximum integer
  type: Test/Echo
  properties:
    output: >-
      [max(
        reference(
          resourceId('Test/Echo', 'Echo integer array')
        ).actualState.output
      )]
  dependsOn:
  - "[resourceId('Test/Echo', 'Echo integer array')]"

dsc config get --document max.example.2.dsc.config.yaml

results:
- name: Echo integer array
  type: Test/Echo
  result:
    actualState:
      output:
      - 3
      - 2
      - 5
      - 1
      - 7
- name: Echo maximum integer
  type: Test/Echo
  result:
    actualState:
      output: 7

Parametrar

integerList

Funktionen max() förväntar sig antingen en enda matris med heltal eller en kommaavgränsad matris med heltal. När du skickar heltal direkt separerar du varje heltal med ett kommatecken. När du skickar ett matrisobjekt tar funktionen bara en enda matris som argument.

Type:         [integer, array(integer)]
Required:     true
MinimumCount: 1
MaximumCount: 18446744073709551615

Utdata

Funktionen max() returnerar ett enda heltal som representerar det största värdet i indata.

Type: integer