Delen via


Get-AzSecurityApiCollection

Hiermee haalt u een Azure API Management-API op als deze is toegevoegd aan Microsoft Defender voor API's. Als een Azure API Management-API wordt toegevoegd aan Microsoft Defender voor API's, controleert het systeem de bewerkingen in de Azure API Management-API op intrusief gedrag en geeft het waarschuwingen voor aanvallen die zijn gedetecteerd.

Syntax

Get-AzSecurityApiCollection
   [-SubscriptionId <String[]>]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzSecurityApiCollection
   -ApiId <String>
   -ResourceGroupName <String>
   -ServiceName <String>
   [-SubscriptionId <String[]>]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzSecurityApiCollection
   -ResourceGroupName <String>
   -ServiceName <String>
   [-SubscriptionId <String[]>]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzSecurityApiCollection
   -ResourceGroupName <String>
   [-SubscriptionId <String[]>]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzSecurityApiCollection
   -InputObject <ISecurityIdentity>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Description

Hiermee haalt u een Azure API Management-API op als deze is toegevoegd aan Microsoft Defender voor API's. Als een Azure API Management-API wordt toegevoegd aan Microsoft Defender voor API's, controleert het systeem de bewerkingen in de Azure API Management-API op intrusief gedrag en geeft het waarschuwingen voor aanvallen die zijn gedetecteerd.

Voorbeelden

Voorbeeld 1: Een specifieke onboarded API-verzamelingsresource ophalen

Get-AzSecurityApiCollection -ResourceGroupName apicollectionstests -ServiceName "demoapimservice2" -ApiId "echo-api"

BaseUrl                                      : https://demoapimservice2.azure-api.net/echo
DiscoveredVia                                : /subscriptions/487bb485-b5b0-471e-9c0d-10717612f869/resourceGroups/apicollectionstests/providers/Microsoft.ApiManagement/service/demoapim
                                               service2
DisplayName                                  : Echo API
Id                                           : /subscriptions/487bb485-b5b0-471e-9c0d-10717612f869/resourceGroups/apicollectionstests/providers/Microsoft.ApiManagement/service/demoapim
                                               service2/providers/Microsoft.Security/apiCollections/echo-api
Name                                         : echo-api
NumberOfApiEndpoint                          : 6
NumberOfApiEndpointsWithSensitiveDataExposed : 0
NumberOfExternalApiEndpoint                  : 0
NumberOfInactiveApiEndpoint                  : 6
NumberOfUnauthenticatedApiEndpoint           : 0
ProvisioningState                            : Succeeded
ResourceGroupName                            : apicollectionstests
SensitivityLabel                             :
Type                                         : microsoft.security/apicollections

Voorbeeld 2: Onboarded API-verzamelingen weergeven op servicenaam

Get-AzSecurityApiCollection -ResourceGroupName "apicollectionstests" -ServiceName "demoapimservice2"

Name       ResourceGroupName
----       -----------------
echo-api   apicollectionstests
echo-api-2 apicollectionstests

Voorbeeld 3: Onboarded API-verzamelingen per abonnement weergeven

Get-AzSecurityApiCollection

Name       ResourceGroupName
----       -----------------
echo-api   apicollectionstests
echo-api-2 apicollectionstests

Parameters

-ApiId

API-revisie-id. Moet uniek zijn in het API Management-service-exemplaar. Niet-huidige herziening heeft ; rev=n als achtervoegsel waarbij n het revisienummer is.

Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

De parameter DefaultProfile is niet functioneel. Gebruik de parameter SubscriptionId indien beschikbaar als u de cmdlet uitvoert voor een ander abonnement.

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Identiteitsparameter

Type:ISecurityIdentity
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.

Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-ServiceName

De naam van de API Management-service.

Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

Azure-abonnements-id

Type:String[]
Position:Named
standaardwaarde:(Get-AzContext).Subscription.Id
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

ISecurityIdentity

Uitvoerwaarden

IApiCollection