Delen via


Invoke-AzSecurityApiCollectionApimOnboard

Onboarding van een Azure API Management-API naar Microsoft Defender voor API's. Het systeem begint met het bewaken van de bewerkingen in de Azure Management-API voor intrusief gedrag en biedt waarschuwingen voor aanvallen die zijn gedetecteerd.

Syntax

Invoke-AzSecurityApiCollectionApimOnboard
      -ApiId <String>
      -ResourceGroupName <String>
      -ServiceName <String>
      [-SubscriptionId <String>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-AzSecurityApiCollectionApimOnboard
      -InputObject <ISecurityIdentity>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Onboarding van een Azure API Management-API naar Microsoft Defender voor API's. Het systeem begint met het bewaken van de bewerkingen in de Azure Management-API voor intrusief gedrag en biedt waarschuwingen voor aanvallen die zijn gedetecteerd.

Voorbeelden

Voorbeeld 1: Een Azure API Management-API onboarden naar Microsoft Defender voor API's.

Invoke-AzSecurityApiCollectionApimOnboard -ResourceGroupName "apicollectionstests" -ServiceName "demoapimservice2" -ApiId "echo-api-2"

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

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

-AsJob

De opdracht uitvoeren als een taak

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
standaardwaarde:None
Vereist:False
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

-NoWait

De opdracht asynchroon uitvoeren

Type:SwitchParameter
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

ISecurityIdentity

Uitvoerwaarden

IApiCollection