Test-PSUAppToken

ÜBERSICHT

Validiert ein PowerShell Universal-App-Token.

SYNTAX

Test-PSUAppToken [-Token] <String> [-Identity <String>] [-Role <String>] [-ComputerName <String>]
 [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate]
 [-Cookies] [<CommonParameters>]

BESCHREIBUNG

Sendet ein Token und optional einen Identitäts- und Rollenkontext an PowerShell Universal und gibt zurück, ob das Token für diesen Kontext gültig ist.

BEISPIELE

Beispiel 1

PS C:\> Test-PSUAppToken -Token "<token>" -Identity "svc-api" -Role "ApiUsers"

Validiert das Token für die Identität svc-api und die Rolle ApiUsers.

PARAMETER

-AppToken

Gibt das App-Token an, das bei der Authentifizierung gegenüber der PowerShell Universal-Verwaltungs-API verwendet wird.

Type: String
Parameter Sets: (All)
Aliases:

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

-ComputerName

Gibt die URL oder den Hostnamen der Ziel-PowerShell Universal-Instanz an. Reine Hostnamen werden in eine http://<host>:5000-URL normalisiert.

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

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

-Cookies

Verwendet und speichert Authentifizierungs-Cookies für die aktuelle PowerShell-Sitzung.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Credential

Gibt die Anmeldeinformationen an, die für die Basic-Authentifizierung gegenüber der PowerShell Universal-Verwaltungs-API verwendet werden.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-Identity

Gibt die Identität an, die adressiert oder validiert werden soll.

Type: String
Parameter Sets: (All)
Aliases:

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

-Integrated

Verwendet den prozessinternen integrierten Verwaltungsclient, wenn das Cmdlet innerhalb von PowerShell Universal ausgeführt wird.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Role

Gibt eine oder mehrere Rollen an, die zugewiesen oder erlaubt werden sollen.

Type: String
Parameter Sets: (All)
Aliases:

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

-Token

Gibt den zu validierenden App-Token-Wert an.

Type: String
Parameter Sets: (All)
Aliases:

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

-TrustCertificate

Erlaubt Verbindungen zu Servern mit nicht vertrauenswürdigen TLS-Zertifikaten.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-UseDefaultCredentials

Verwendet die aktuellen Windows-Anmeldeinformationen bei der Authentifizierung gegenüber der Verwaltungs-API.

Type: SwitchParameter
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.