Condividi tramite


Set-AzIotSecuritySolution

Creare o aggiornare la soluzione di sicurezza IoT

Sintassi

Set-AzIotSecuritySolution
   -Name <String>
   -ResourceGroupName <String>
   [-Tag <Hashtable>]
   -Location <String>
   -Workspace <String>
   -DisplayName <String>
   [-Enabled <Boolean>]
   [-Export <String[]>]
   [-DisabledDataSource <String[]>]
   -IotHub <String[]>
   [-UserDefinedResource <PSUserDefinedResources>]
   [-RecommendationsConfiguration <PSRecommendationConfiguration[]>]
   [-UnmaskedIpLoggingStatus <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzIotSecuritySolution
   -InputObject <PSIotSecuritySolution>
   [-Tag <Hashtable>]
   -Location <String>
   -Workspace <String>
   -DisplayName <String>
   [-Enabled <Boolean>]
   [-Export <String[]>]
   [-DisabledDataSource <String[]>]
   -IotHub <String[]>
   [-UserDefinedResource <PSUserDefinedResources>]
   [-RecommendationsConfiguration <PSRecommendationConfiguration[]>]
   [-UnmaskedIpLoggingStatus <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzIotSecuritySolution
   -ResourceId <String>
   [-Tag <Hashtable>]
   -Location <String>
   -Workspace <String>
   -DisplayName <String>
   [-Enabled <Boolean>]
   [-Export <String[]>]
   [-DisabledDataSource <String[]>]
   -IotHub <String[]>
   [-UserDefinedResource <PSUserDefinedResources>]
   [-RecommendationsConfiguration <PSRecommendationConfiguration[]>]
   [-UnmaskedIpLoggingStatus <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-AzIotSecuritySolution crea o aggiorna una soluzione di sicurezza iot specifica. La soluzione di sicurezza IoT raccoglie i dati e gli eventi di sicurezza dai dispositivi iot e dall'hub iot per prevenire e rilevare le minacce. Il nome della soluzione di sicurezza iot deve essere identico al nome dell'hub iot.

Esempio

Esempio 1

$Workspace = "/subscriptions/XXXXXXXX-XXXX-XXXXX-XXXX-XXXXXXXXXXXX/resourceGroups/MichalResourceGroup/providers/Microsoft.OperationalInsights/workspaces/IoTHubWorkspace"
$IotHubs = @("/subscriptions/XXXXXXXX-XXXX-XXXXX-XXXX-XXXXXXXXXXXX/resourceGroups/MichalResourceGroup/providers/Microsoft.Devices/IotHubs/MySample")
Set-AzIotSecuritySolution -Name "MySample" -ResourceGroupName "MyResourceGroup" -Location "West US" `
-Workspace $Workspace -DisplayName "MySample" -Enabled $true -IotHub $IotHubs

Id: "/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/MyResourceGroup/providers/Microsoft.Security/IoTSecuritySolutions/MySample"
Name: "MySample"
Type: "Microsoft.Security/IoTSecuritySolutions"
Location: "westus"
DisplayName: "MySample"
status: "Enabled"
Export: ["RawEvents"]
DisabledDataSources: ["TwinData"]
Workspace: "/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourcegroups/MyResourceGroup/providers/microsoft.operationalinsights/workspaces/MyLA"
AdditionalWorkspaces: null
IotHubs: ["/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourcegroups/MyResourceGroup/providers/microsoft.devices/iothubs/MySample"]
UserDefinedResources: {
	Query: "" 
	QuerySubscriptions: []
}
RecommendationsConfiguration: [
{
	RecommendationType: "IoT_ACRAuthentication"
	Name: "Service prinicpal not used with ACR repository"
	Status: "Enabled"
}
{
	RecommendationType: "IoT_AgentSendsUnutilizedMessages"
	Name: "Agent sending underutilized messages"
	Status: "Enabled"
	}]
AutoDiscoveredResources: ["/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourcegroups/MyResourceGroup/providers/microsoft.devices/iothubs/MySample"]
UnmaskedIpLoggingStatus: "Enabled"
Tags: {}

Creare una nuova soluzione di sicurezza iot "MySample" per l'hub IoT con ID risorsa "/subscriptions/XXXXXXXX-XXXX-XXXXX-XXXXXXXXXXXXXXX/resourceGroups/MichalResourceGroup/providers/Microsoft.Devices/IotHubs/MySample" (il nome della soluzione deve essere identico al nome dell'hub IoT)

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisabledDataSource

Origini dati disabilitate.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Nome visualizzato.

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

-Enabled

Stato.

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

-Export

Esportazione dati.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Oggetto di input.

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

-IotHub

Hub Iot.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Location

Posizione.

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

-Name

Nome risorsa.

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

-RecommendationsConfiguration

Consigli configurazione.

Type:PSRecommendationConfiguration[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Nome del gruppo di risorse.

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

-ResourceId

ID della risorsa di sicurezza su cui si desidera richiamare il comando.

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

-Tag

Tag.

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

-UnmaskedIpLoggingStatus

Stato di registrazione ip non mascherato.

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

-UserDefinedResource

Risorse definite dall'utente.

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Workspace

ID area di lavoro.

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

Input

PSIotSecuritySolution

String

Hashtable

String[]

PSUserDefinedResources

PSRecommendationConfiguration[]

Output

PSIotSecuritySolution