Invoke-PSUEndpoint

ÜBERSICHT

Ruft einen benutzerdefinierten API-Endpunkt intern auf.

SYNTAX

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>]

BESCHREIBUNG

Dieses Cmdlet bietet die Möglichkeit, einen Endpunkt auszuführen, ohne direkt auf den Webserver zuzugreifen.

BEISPIELE

Beispiel 1

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

Gibt einen API-Endpunkt intern zurück.

PARAMETER

-AppToken

Ein App-Token, das für den Zugriff auf den Endpunkt verwendet wird.

Type: String
Parameter Sets: (All)
Aliases:

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

-Body

Der Body der HTTP-Anfrage.

Type: String
Parameter Sets: (All)
Aliases:

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

-ComputerName

Der Name oder die URL des PowerShell Universal-Servers, auf den zugegriffen werden soll.

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

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

-ContentType

Der Wert des HTTP-Content-Type-Headers. Standardwert ist application/json.

Type: String
Parameter Sets: (All)
Aliases:

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

-Cookies

Eine Hashtable von Cookies, die an die API gesendet werden.

Type: Hashtable
Parameter Sets: (All)
Aliases:

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

-Credential

Anmeldeinformationen für die Anmeldung bei der PowerShell Universal Management API.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-Headers

Eine Hashtable von Headern, die an den API-Endpunkt gesendet werden.

Type: Hashtable
Parameter Sets: (All)
Aliases:

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

-Integrated

Ob das integrierte Sicherheitsmodell verwendet werden soll.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Method

Die HTTP-Methode des API-Endpunkts.

Type: String
Parameter Sets: (All)
Aliases:

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

-TrustCertificate

Ob das Cmdlet Zertifikatsprobleme ignorieren soll.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Url

Die relative URL des API-Endpunkts.

Type: String
Parameter Sets: (All)
Aliases:

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

-UseDefaultCredentials

Ob beim Verbinden mit PowerShell Universal die Standardanmeldeinformationen verwendet werden sollen. Erfordert, dass die Windows-Authentifizierung aktiviert ist.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ResponseVariable

Gibt den Variablennamen an, der das vollständige API-Antwortobjekt nach dem Aufruf des Endpunkts erhält. Der Antwort-Body wird weiterhin in die Pipeline geschrieben.

Type: String
Parameter Sets: (All)
Aliases:

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

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable und -ProgressAction. Weitere Informationen finden Sie unter about_CommonParameters.