# Invoke-MtAzureRequest

Invoke a REST API request to the Azure Management API.

Source: https://maester.dev/docs/commands/Invoke-MtAzureRequest

## SYNOPSIS

Invoke a REST API request to the Azure Management API.

## SYNTAX

```powershell
Invoke-MtAzureRequest [-RelativeUri] <String> [[-Method] <String>] [[-ApiVersion] <Object>]
 [[-Filter] <String>] [[-Select] <String>] [[-Payload] <String>] [-Graph] [-ProgressAction <ActionPreference>]
 [<CommonParameters>]
```

## DESCRIPTION

This function allows you to make REST API requests to the Azure Management API.
It is a wrapper around the Invoke-AzRest function, providing a simplified interface.

## EXAMPLES

### EXAMPLE 1

```powershell
Invoke-MtAzureRequest -RelativeUri 'subscriptions'
```

## PARAMETERS

### -RelativeUri

Graph endpoint such as "users".

```yaml
Type: String
Parameter Sets: (All)
Aliases: Path

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

### -Method

The HTTP method to use.
Default is GET.

```yaml
Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: GET
Accept pipeline input: False
Accept wildcard characters: False
```

### -ApiVersion

The API version to use.
Default is 2024-11-01

```yaml
Type: Object
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: 2024-11-01
Accept pipeline input: False
Accept wildcard characters: False
```

### -Filter

Filter parameters to include in the request.
E.g.
"displayName eq 'John'"

```yaml
Type: String
Parameter Sets: (All)
Aliases:

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

### -Select

Select parameters to include in the request.
E.g.
"id,displayName"

```yaml
Type: String
Parameter Sets: (All)
Aliases:

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

### -Payload

The body payload for POST/PATCH/PUT requests

```yaml
Type: String
Parameter Sets: (All)
Aliases: Body

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

### -Graph

Use Microsoft Graph endpoint.
Defaults to Azure Resource Manager, if enabled requests will go to Microsoft Graph

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

### -ProgressAction

Determines how PowerShell responds to progress updates generated by a script, cmdlet, or provider, such as the progress bars generated by Write-Progress.

```yaml
Type: ActionPreference
Parameter Sets: (All)
Aliases: proga

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

### CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).

## INPUTS

## OUTPUTS

## NOTES

## RELATED LINKS

[https://maester.dev/docs/commands/Invoke-MtAzureRequest](https://maester.dev/docs/commands/Invoke-MtAzureRequest)