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.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisabledDataSource

Origini dati disabilitate.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisplayName

Nome visualizzato.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Enabled

Stato.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Export

Esportare i dati.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Oggetto di input.

Tipo:PSIotSecuritySolution
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-IotHub

Hub Iot.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Location

Ubicazione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Nome risorsa.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RecommendationsConfiguration

Configurazione delle raccomandazioni.

Tipo:PSRecommendationConfiguration[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResourceGroupName

Nome del gruppo di risorse.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResourceId

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Tag

Tag.

Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UnmaskedIpLoggingStatus

Stato di registrazione ip non mascherato.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UserDefinedResource

Risorse definite dall'utente.

Tipo:PSUserDefinedResources
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Workspace

ID area di lavoro.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

PSIotSecuritySolution

String

Hashtable

String[]

PSUserDefinedResources

PSRecommendationConfiguration[]

Output

PSIotSecuritySolution