Condividi tramite

New-AzDataFactoryEncryptValue

Modulo:
Az.DataFactory Module

Crittografa i dati sensibili.

Sintassi

ByFactoryName (Impostazione predefinita) 

New-AzDataFactoryEncryptValue
    [-DataFactoryName] <String>
    [[-Value] <SecureString>]
    [-GatewayName] <String>
    [[-Credential] <PSCredential>]
    [[-Type] <String>]
    [[-NonCredentialValue] <String>]
    [[-AuthenticationType] <String>]
    [[-Server] <String>]
    [[-Database] <String>]
    [-ResourceGroupName] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ByFactoryObject 

New-AzDataFactoryEncryptValue
    [-DataFactory] <PSDataFactory>
    [[-Value] <SecureString>]
    [-GatewayName] <String>
    [[-Credential] <PSCredential>]
    [[-Type] <String>]
    [[-NonCredentialValue] <String>]
    [[-AuthenticationType] <String>]
    [[-Server] <String>]
    [[-Database] <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Descrizione

Il cmdlet New-AzDataFactoryEncryptValue crittografa i dati sensibili, ad esempio una password o un SQL Server connection string Microsoft e restituisce un valore crittografato.

Esempio

Esempio 1: Crittografare un connection string non ODBC

$Value = ConvertTo-SecureString 'Data Source=ContosoServer;Initial Catalog=catalog;user id =user123;password=******' -AsPlainText -Force
New-AzDataFactoryEncryptValue -GatewayName "WikiGateway" -DataFactoryName "WikiAdf" -Value $value -ResourceGroupName "ADF" -Type OnPremisesSqlLinkedService

Il primo comando usa il cmdlet ConvertTo-SecureString per convertire il connection string specificato in un oggetto SecureString e quindi archivia tale oggetto nella variabile $Value. Per altre informazioni, digitare . Valori consentiti: SQL Server o oracle connection string. Il secondo comando crea un valore crittografato per l'oggetto archiviato in $Value per la data factory, il gateway, il gruppo di risorse e il tipo di servizio collegato specificati.

Esempio 2: crittografare un connection string non ODBC che usa Windows authentication.

$Value = ConvertTo-SecureString -String 'Data Source=ContosoServer;Initial Catalog=catalog;Integrated Security=True' -AsPlainText -Force
$Credential = Get-Credential
New-AzDataFactoryEncryptValue -DataFactoryName "WikiADF" -GatewayName "WikiGateway" -ResourceGroupName "ADF" -Value $Value -Credential $Credential -Type OnPremisesSqlLinkedService

Il primo comando usa ConvertTo-SecureString per convertire il connection string specificato in un oggetto stringa sicuro e quindi archivia tale oggetto nella variabile $Value. Il secondo comando usa il cmdlet Get-Credential per raccogliere l'autenticazione di Windows (nome utente e password) e quindi archivia l'oggetto PSCredential nella variabile $Credential. Per altre informazioni, digitare . Il terzo comando crea un valore crittografato per l'oggetto archiviato in $Value e $Credential per la data factory, il gateway, il gruppo di risorse e il tipo di servizio collegato specificati.

Esempio 3: Crittografare il nome del server e le credenziali per il servizio collegato file system

$Value = ConvertTo-SecureString "******" -AsPlainText -Force
$Credential = Get-Credential
New-AzDataFactoryEncryptValue -DataFactoryName "WikiADF" -GatewayName "WikiGateway" -ResourceGroupName "ADF" -Value $Value -Credential $Credential -Type OnPremisesFileSystemLinkedService

Il primo comando usa ConvertTo-SecureString per convertire la stringa specificata in una stringa protetta e quindi archivia tale oggetto nella variabile $Value. Il secondo comando usa Get-Credential per raccogliere il Windows authentication (nome utente e password) e quindi archivia tale oggetto PSCredential nella variabile $Credential. Il terzo comando crea un valore crittografato per l'oggetto archiviato in $Value e $Credential per la data factory, il gateway, il gruppo di risorse e il tipo di servizio collegato specificati.

Esempio 4: Crittografare le credenziali per il servizio collegato HDFS

$UserName = ConvertTo-SecureString "******" -AsPlainText -Force
$Password = ConvertTo-SecureString "******" -AsPlainText -Force
$Credential = New-Object System.Management.Automation.PSCredential ($UserName, $Password)
New-AzDataFactoryEncryptValue -DataFactoryName "MyDataFactory" -ResourceGroupName "MyResourceGroup" -GatewayName "MyDataManagementGateway" -Type HdfsLinkedService -AuthenticationType Windows -Credential $Credential -NonCredentialValue "http://server01.com:50070/webhdfs/v1/user/username"

Il comando ConvertTo-SecureString converte la stringa specificata in una stringa sicura. Il comando New-Object crea un oggetto PSCredential usando le stringhe di nome utente e password sicure. È invece possibile usare il comando Get-Credential per raccogliere Windows authentication (nome utente e password) e quindi archiviare l'oggetto PSCredential nella variabile $credential, come illustrato negli esempi precedenti. Il comando New-AzDataFactoryEncryptValue crea un valore crittografato per l'oggetto archiviato in $Credential per la data factory, il gateway, il gruppo di risorse e il tipo di servizio collegato specificati.

Esempio 5: Crittografare le credenziali per il servizio collegato ODBC

$Content = ConvertTo-SecureString "UID=username@contoso;PWD=******;" -AsPlainText -Force
New-AzDataFactoryEncryptValue -ResourceGroupName $RGName -DataFactoryName $DFName -GatewayName $Gateway -Type OnPremisesOdbcLinkedService -AuthenticationType Basic -NonCredentialValue "Driver={SQL Server};Server=server01.database.contoso.net; Database=HDISScenarioTest;" -Value $content

Il comando ConvertTo-SecureString converte la stringa specificata in una stringa sicura. Il comando New-AzDataFactoryEncryptValue crea un valore crittografato per l'oggetto archiviato in $Value per la data factory, il gateway, il gruppo di risorse e il tipo di servizio collegato specificati.

Parametri

-AuthenticationType

Specifica il tipo di autenticazione da utilizzare per connettersi all'origine dati. I valori accettabili per questo parametro sono:

  • Windows
  • Di base
  • Anonimo.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Valori accettati:Windows, Basic, Anonymous
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:6
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Credential

Specifica le credenziali di Windows authentication (nome utente e password) da usare. Questo cmdlet crittografa i dati delle credenziali specificati qui.

Proprietà dei parametri

Tipo:PSCredential
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:3
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Database

Specifica il nome del database del servizio collegato.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:8
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DataFactory

Specifica un oggetto PSDataFactory . Questo cmdlet crittografa i dati per la data factory specificata da questo parametro.

Proprietà dei parametri

Tipo:PSDataFactory
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByFactoryObject
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-DataFactoryName

Specifica il nome di una data factory. Questo cmdlet crittografa i dati per la data factory specificata da questo parametro.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByFactoryName
Posizione:1
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-DefaultProfile

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

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-GatewayName

Specifica il nome del gateway. Questo cmdlet crittografa i dati per il gateway specificato da questo parametro.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:2
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-NonCredentialValue

Specifica la parte non credenziale del connection string ODBC (Open Database Connectivity). Questo parametro è applicabile solo per il servizio collegato ODBC.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:5
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ResourceGroupName

Specifica il nome di un gruppo di risorse Azure. Questo cmdlet crittografa i dati per il gruppo specificato da questo parametro.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByFactoryName
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Server

Specifica il nome del server del servizio collegato.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:7
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Type

Specifica il tipo di servizio collegato. Questo cmdlet crittografa i dati per il tipo di servizio collegato specificato da questo parametro. I valori accettabili per questo parametro sono:

  • OnPremisesSqlLinkedService
  • OnPremisesFileSystemLinkedService
  • OnPremisesOracleLinkedService
  • OnPremisesOdbcLinkedService
  • OnPremisesPostgreSqlLinkedService
  • OnPremisesTeradataLinkedService
  • OnPremisesMySQLLinkedService
  • OnPremisesDB2LinkedService
  • OnPremisesSybaseLinkedService

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Valori accettati:OnPremisesSqlLinkedService, OnPremisesFileSystemLinkedService, OnPremisesOracleLinkedService, OnPremisesOdbcLinkedService, OnPremisesPostgreSqlLinkedService, OnPremisesTeradataLinkedService, OnPremisesMySQLLinkedService, OnPremisesDB2LinkedService, OnPremisesSybaseLinkedService, HdfsLinkedService
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:4
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Value

Specifica il valore da crittografare. Per un servizio collegato SQL Server locale e un servizio collegato Oracle locale, usare un connection string. Per un servizio collegato ODBC locale, usare la parte delle credenziali del connection string. Per il servizio collegato al file system locale, se il file system è locale nel computer gateway, usare Local o localhost e se il file system si trova in un server diverso dal computer gateway, usare \\servername.

Proprietà dei parametri

Tipo:SecureString
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

PSDataFactory

String

Output

String

Note

  • Parole chiave: azure, azurerm, arm, resource, management, manager, data, factory