Invoke-AzSecurityApiCollectionApimOnboard
Integre uma API de Gerenciamento de API do Azure ao Microsoft Defender para APIs.
O sistema começará a monitorar as operações dentro da API de Gerenciamento do Azure em busca de comportamentos intrusivos e fornecerá alertas para ataques que foram detetados.
Sintaxe
Azure (Predefinição)
Invoke-AzSecurityApiCollectionApimOnboard
-ApiId <String>
-ResourceGroupName <String>
-ServiceName <String>
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
AzureViaIdentity
Invoke-AzSecurityApiCollectionApimOnboard
-InputObject <ISecurityIdentity>
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Integre uma API de Gerenciamento de API do Azure ao Microsoft Defender para APIs.
O sistema começará a monitorar as operações dentro da API de Gerenciamento do Azure em busca de comportamentos intrusivos e fornecerá alertas para ataques que foram detetados.
Exemplos
Exemplo 1: Integre uma API de Gerenciamento de API do Azure ao Microsoft Defender for APIs.
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
Parâmetros
-ApiId
Identificador de revisão da API.
Deve ser exclusivo na instância de serviço de Gerenciamento de API.
Revisão não corrente tem ; rev=n como sufixo onde n é o número de revisão.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
Azure
Position: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-AsJob
Executar o comando como um trabalho
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: Cf.
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-DefaultProfile
O parâmetro DefaultProfile não é funcional.
Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.
Propriedades dos parâmetros
Tipo: PSObject
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: AzureRMContext, AzureCredential
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
Parâmetro de identidade
Tipo: ISecurityIdentity
Default value: None Suporta carateres universais: False NãoMostrar: False
AzureViaIdentity
Position: Named Obrigatório: True Valor do pipeline: True Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-NoWait
Execute o comando de forma assíncrona
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ResourceGroupName
O nome do grupo de recursos.
O nome não diferencia maiúsculas de minúsculas.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
Azure
Position: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ServiceName
O nome do serviço de Gerenciamento de API.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
Azure
Position: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-SubscriptionId
Id de subscrição do Azure
Propriedades dos parâmetros
Tipo: String
Default value: (Get-AzContext).Subscription.Id Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
Azure
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: Wi
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas
