Invoke-AzSecurityApiCollectionApimOnboard

Modul:

Az.Security

Onboarding rozhraní API služby Azure API Management do Microsoft Defenderu pro rozhraní API Systém začne monitorovat operace v rozhraní API pro správu Azure za účelem rušivého chování a poskytne výstrahy pro zjištěné útoky.

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 rozhraní API služby Azure API Management do Microsoft Defenderu pro rozhraní API Systém začne monitorovat operace v rozhraní API pro správu Azure za účelem rušivého chování a poskytne výstrahy pro zjištěné útoky.

Příklady

Příklad 1: Připojení rozhraní API služby Azure API Management do Microsoft Defenderu pro rozhraní API

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

Parametry

-ApiId

Identifikátor revize rozhraní API. V instanci služby API Management musí být jedinečné. Revize, která není aktuální, má ; rev=n jako přípona, kde n je číslo revize.

Typ:	String
Position:	Named
výchozí hodnota:	None
Vyžadováno:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-AsJob

Spuštění příkazu jako úlohy

Typ:	SwitchParameter
Position:	Named
výchozí hodnota:	None
Vyžadováno:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:	SwitchParameter
Aliases:	cf
Position:	Named
výchozí hodnota:	None
Vyžadováno:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Parametr DefaultProfile není funkční. Pokud je k dispozici spuštění rutiny pro jiné předplatné, použijte parametr SubscriptionId.

Typ:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
výchozí hodnota:	None
Vyžadováno:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Parametr identity

Typ:	ISecurityIdentity
Position:	Named
výchozí hodnota:	None
Vyžadováno:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NoWait

Asynchronní spuštění příkazu

Typ:	SwitchParameter
Position:	Named
výchozí hodnota:	None
Vyžadováno:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Název skupiny zdrojů. Název nerozlišuje malá a velká písmena.

Typ:	String
Position:	Named
výchozí hodnota:	None
Vyžadováno:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ServiceName

Název služby API Management.

Typ:	String
Position:	Named
výchozí hodnota:	None
Vyžadováno:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

ID předplatného Azure

Typ:	String
Position:	Named
výchozí hodnota:	(Get-AzContext).Subscription.Id
Vyžadováno:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:	SwitchParameter
Aliases:	wi
Position:	Named
výchozí hodnota:	None
Vyžadováno:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Vstupy

ISecurityIdentity

Výstupy

IApiCollection