New-PSURateLimit

ÜBERSICHT

Erstellt ein neues Ratenlimit für den PowerShell Universal-Server.

SYNTAX

New-PSURateLimit [-Name <String>] -Endpoint <String> -Period <TimeSpan> -Limit <Int32> [-ComputerName <String>]
 [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate]
 [-Cookies] [<CommonParameters>]

BESCHREIBUNG

Erstellt ein neues Ratenlimit für den PowerShell Universal-Server. Ratenlimits betreffen den gesamten Server. Sie können den Umfang des Ratenlimits anhand von URLs einschränken.

Ratenlimit-Konfigurationen werden in .universal/rateLimits.ps1 gespeichert

Sie können dieses Cmdlet auch verwenden, um Ratenlimits über die REST-API zu erstellen.

Sie können Set-PSUSetting verwenden, um Zulassungslisten für IPs, Endpunkte und Computernamen zu konfigurieren, die nicht von der Ratenbegrenzung betroffen sind.

BEISPIELE

Beispiel 1

New-PSURateLimit -Endpoint "/myEndpoint" -Period ([TimeSpan]::FromMinutes(10)) -Limit 100

Erstellt ein neues Ratenlimit, das verhindert, dass der Benutzer den Endpunkt /myEndpoint mehr als 100 Mal in 10 Minuten aufruft.

PARAMETER

-AppToken

Das AppToken, das zum Aufrufen der PowerShell Universal Management API verwendet wird. Sie können auch Connect-PSUServer aufrufen, bevor Sie dieses Cmdlet aufrufen, um das AppToken für die gesamte Sitzung festzulegen.

Type: String
Parameter Sets: (All)
Aliases:

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

-ComputerName

Gibt den Computernamen oder die URL an, die beim Zugriff auf die PowerShell Universal Management API aufgerufen werden soll. Sie können auch Connect-PSUServer verwenden, bevor Sie dieses Cmdlet aufrufen, um den Computernamen für die gesamte Sitzung festzulegen.

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

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

-Endpoint

Die URL des Endpunkts, der einer Ratenbegrenzung unterliegen soll. Die URL kann Platzhalter mit dem Zeichen * enthalten.

Type: String
Parameter Sets: (All)
Aliases:

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

-Limit

Die Anzahl der Anfragen über den Zeitraum.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Period

Der Zeitraum, für den das Limit durchgesetzt wird.

Type: TimeSpan
Parameter Sets: (All)
Aliases:

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

-UseDefaultCredentials

Standard-Anmeldeinformationen bei der Verbindung mit der Management-API verwenden

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Integrated

Führt den Befehl intern aus, anstatt die Management-API zu verwenden. Funktioniert nur, wenn das Skript 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

-Credential

Anmeldeinformationen für die Anmeldung an 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

-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

-Name

Der Name dieser Ratenlimit-Regel.

Type: String
Parameter Sets: (All)
Aliases:

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

-Cookies

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

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.