New-AzureRmDataFactoryEncryptValue

Riferimento

Modulo:: AzureRM.DataFactories

Crittografa i dati sensibili.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

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

New-AzureRmDataFactoryEncryptValue
   [-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-AzureRmDataFactoryEncryptValue crittografa i dati sensibili, ad esempio una password o un stringa di connessione di Microsoft SQL Server e restituisce un valore crittografato.

Esempio

Esempio 1: Crittografare un stringa di connessione non ODBC

PS C:\>$Value = ConvertTo-SecureString 'Data Source=ContosoServer;Initial Catalog=catelog;user id =user123;password=password123' -AsPlainText -Force 
PS C:\> New-AzureRmDataFactoryEncryptValue -GatewayName "WikiGateway" -DataFactoryName "WikiAdf" -Value $value -ResourceGroupName "ADF" -Type OnPremisesSqlLinkedService

Il primo comando usa il cmdlet ConvertTo-SecureString per convertire il stringa di connessione specificato in un oggetto SecureString e quindi archivia tale oggetto nella variabile $Value. Per ulteriori informazioni, digitare Get-Help ConvertTo-SecureString. Valori consentiti: SQL Server o Oracle stringa di connessione. 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 stringa di connessione non ODBC che usa autenticazione di Windows.

PS C:\>$Value = ConvertTo-SecureString 'Data Source=ContosoServer;Initial Catalog=catelog;Integrated Security=True' -AsPlainText -Force
PS C:\> $Credential = Get-Credential
PS C:\> New-AzureRmDataFactoryEncryptValue -DataFactoryName "WikiADF" -GatewayName "WikiGateway" -ResourceGroupName "ADF" -Value $Value -Credential $Credential -Type OnPremisesSqlLinkedService $Value = ConvertTo-SecureString 'Data Source=ContosoServer;Initial Catalog=catelog;Integrated Security=True' -AsPlainText -Force

Il primo comando usa ConvertTo-SecureString per convertire il stringa di connessione 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 ulteriori informazioni, digitare Get-Help Get-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 3: Crittografare il nome del server e le credenziali per il servizio collegato file system

PS C:\>$Value = ConvertTo-SecureString '\\servername' -AsPlainText -Force
PS C:\> $Credential = Get-Credential
PS C:\> New-AzureRmDataFactoryEncryptValue -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 sicura e quindi archivia tale oggetto nella variabile $Value. Il secondo comando usa Get-Credential per raccogliere l'autenticazione di Windows (nome utente e password) e quindi archivia l'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

PS C:\>$UserName = ConvertTo-SecureString "domain\\username" -AsPlainText -Force
$Password = ConvertTo-SecureString "password" -AsPlainText -Force
$Credential = New-Object System.Management.Automation.PSCredential ($UserName, $Password)
New-AzureRmDataFactoryEncryptValue -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 l'autenticazione di Windows (nome utente e password) e quindi archiviare l'oggetto PSCredential restituito nella variabile $credential, come illustrato negli esempi precedenti. Il comando New-AzureRmDataFactoryEncryptValue 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

PS C:\>$Content = ConvertTo-SecureString "UID=username@contoso;PWD=password;" -AsPlainText -Force
New-AzureRmDataFactoryEncryptValue -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-AzureRmDataFactoryEncryptValue 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 validi per questo parametro sono:

Windows
Di base
Anonimo.

Type:	String
Accepted values:	Windows, Basic, Anonymous
Position:	6
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

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

Type:	PSCredential
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Database

Specifica il nome del database del servizio collegato.

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

-DataFactory

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

Type:	PSDataFactory
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DataFactoryName

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

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

-DefaultProfile

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

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

-GatewayName

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

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

-NonCredentialValue

Specifica la parte non credenziale del stringa di connessione Open Database Connessione ivity (ODBC). Questo parametro è applicabile solo per il servizio collegato ODBC.

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

-ResourceGroupName

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

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

-Server

Specifica il nome del server del servizio collegato.

Type:	String
Position:	7
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 validi per questo parametro sono:

OnPremisesSqlLinkedService
OnPremisesFileSystemLinkedService
OnPremisesOracleLinkedService
OnPremisesOdbcLinkedService
OnPremisesPostgreSqlLinkedService
OnPremisesTeradataLinkedService
OnPremisesMySQLLinkedService
OnPremisesDB2LinkedService
OnPremisesSybaseLinkedService

Type:	String
Accepted values:	OnPremisesSqlLinkedService, OnPremisesFileSystemLinkedService, OnPremisesOracleLinkedService, OnPremisesOdbcLinkedService, OnPremisesPostgreSqlLinkedService, OnPremisesTeradataLinkedService, OnPremisesMySQLLinkedService, OnPremisesDB2LinkedService, OnPremisesSybaseLinkedService, HdfsLinkedService
Position:	4
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Value

Specifica il valore da crittografare. Per un servizio collegato di SQL Server locale e un servizio collegato Oracle locale, usare un stringa di connessione. Per un servizio collegato ODBC locale, usare la parte delle credenziali del stringa di connessione. 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.

Type:	SecureString
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Input

PSDataFactory

String

Output