Invoke-PSUEndpoint

SINOPSIS

Invoca un endpoint de API personalizado internamente.

SINTAXIS

Invoke-PSUEndpoint -Url <String> [-Headers <Hashtable>] [-Cookies <Hashtable>] [-Body <String>]
 [-Method <String>] [-ContentType <String>] [-ResponseVariable <String>] [-ComputerName <String>]
 [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate]
 [<CommonParameters>]

DESCRIPCIÓN

Este cmdlet ofrece la posibilidad de ejecutar un endpoint sin acceder directamente al servidor web.

EJEMPLOS

Ejemplo 1

PS C:\> Invoke-PSUEndpoint -URL '/myapi'

Devuelve un endpoint de API internamente.

PARÁMETROS

-AppToken

Un token de aplicación utilizado para acceder al endpoint.

Type: String
Parameter Sets: (All)
Aliases:

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

-Body

El cuerpo de la solicitud HTTP.

Type: String
Parameter Sets: (All)
Aliases:

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

-ComputerName

El nombre o la URL del servidor de PowerShell Universal al que acceder.

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

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

-ContentType

El valor de la cabecera de tipo de contenido HTTP. El valor predeterminado es application/json.

Type: String
Parameter Sets: (All)
Aliases:

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

-Cookies

Una tabla hash de cookies que se enviarán a la API.

Type: Hashtable
Parameter Sets: (All)
Aliases:

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

-Credential

Credenciales para iniciar sesión en la API de gestión de PowerShell Universal.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-Headers

Una tabla hash de cabeceras que se enviarán al endpoint de la API.

Type: Hashtable
Parameter Sets: (All)
Aliases:

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

-Integrated

Si se debe utilizar el modelo de seguridad integrada.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Method

El método HTTP del endpoint de la API.

Type: String
Parameter Sets: (All)
Aliases:

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

-TrustCertificate

Si el cmdlet debe ignorar los problemas de certificados.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Url

La URL relativa del endpoint de la API.

Type: String
Parameter Sets: (All)
Aliases:

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

-UseDefaultCredentials

Si se deben utilizar las credenciales predeterminadas al conectarse a PowerShell Universal. Requiere que la autenticación de Windows esté habilitada.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ResponseVariable

Especifica el nombre de la variable que recibe el objeto de respuesta completo de la API después de invocar el endpoint. El cuerpo de la respuesta se sigue escribiendo en la canalización.

Type: String
Parameter Sets: (All)
Aliases:

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

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable y -ProgressAction. Para más información, consulte about_CommonParameters.