New-AzDataFactoryEncryptValue

Referência

Módulo:: Az.DataFactory

Criptografa dados confidenciais.

Syntax

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>]

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

Description

O cmdlet New-AzDataFactoryEncryptValue criptografa dados confidenciais, como uma senha ou uma cadeia de conexão do Microsoft SQL Server, e retorna um valor criptografado.

Exemplos

Exemplo 1: Criptografar uma cadeia de conexão não ODBC

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

O primeiro comando usa o cmdlet ConvertTo-SecureString para converter a cadeia de conexão especificada em um objeto SecureString e, em seguida, armazena esse objeto na variável $Value. Para obter mais informações, digite Get-Help ConvertTo-SecureString. Valores permitidos: cadeia de conexão SQL Server ou Oracle. O segundo comando cria um valor criptografado para o objeto armazenado no $Value para o data factory, gateway, grupo de recursos e tipo de serviço vinculado especificado.

Exemplo 2: Criptografar uma cadeia de conexão não ODBC que usa a autenticação do Windows.

$Value = ConvertTo-SecureString '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

O primeiro comando usa ConvertTo-SecureString para converter a cadeia de conexão especificada em um objeto de cadeia de caracteres segura e, em seguida, armazena esse objeto na variável $Value. O segundo comando usa o cmdlet Get-Credential para coletar a autenticação do Windows (nome de usuário e senha) e, em seguida, armazena esse objeto PSCredential na variável $Credential. Para obter mais informações, digite Get-Help Get-Credential. O terceiro comando cria um valor criptografado para o objeto armazenado no $Value e $Credential para o data factory, gateway, grupo de recursos e tipo de serviço vinculado especificado.

Exemplo 3: Criptografar o nome e as credenciais do servidor para o serviço vinculado ao sistema de arquivos

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

O primeiro comando usa ConvertTo-SecureString para converter a cadeia de caracteres especificada em uma cadeia de caracteres segura e, em seguida, armazena esse objeto na variável $Value. O segundo comando usa Get-Credential para coletar a autenticação do Windows (nome de usuário e senha) e, em seguida, armazena esse objeto PSCredential na variável $Credential. O terceiro comando cria um valor criptografado para o objeto armazenado no $Value e $Credential para o data factory, gateway, grupo de recursos e tipo de serviço vinculado especificado.

Exemplo 4: Criptografar credenciais para o serviço vinculado HDFS

$UserName = ConvertTo-SecureString "domain\\username" -AsPlainText -Force
$Password = ConvertTo-SecureString "password" -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"

O comando ConvertTo-SecureString converte a cadeia de caracteres especificada em uma cadeia de caracteres segura. O comando New-Object cria um objeto PSCredential usando as cadeias de caracteres seguras de nome de usuário e senha. Em vez disso, você pode usar o comando Get-Credential para coletar a autenticação do Windows (nome de usuário e senha) e, em seguida, armazenar o objeto PSCredential retornado na variável $credential, conforme mostrado em exemplos anteriores. O comando New-AzDataFactoryEncryptValue cria um valor criptografado para o objeto armazenado no $Credential para o data factory, gateway, grupo de recursos e tipo de serviço vinculado especificado.

Exemplo 5: Criptografar credenciais para o serviço vinculado ODBC

$Content = ConvertTo-SecureString "UID=username@contoso;PWD=password;" -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

O comando ConvertTo-SecureString converte a cadeia de caracteres especificada em uma cadeia de caracteres segura. O comando New-AzDataFactoryEncryptValue cria um valor criptografado para o objeto armazenado no $Value para o data factory, gateway, grupo de recursos e tipo de serviço vinculado especificado.

Parâmetros

-AuthenticationType

Especifica o tipo de autenticação a ser usado para se conectar à fonte de dados. Os valores aceitáveis para esse parâmetro são:

Windows
Basic
Anônimo.

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

-Credential

Especifica as credenciais de autenticação do Windows (nome de usuário e senha) a serem usadas. Esse cmdlet criptografa os dados de credenciais especificados aqui.

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

-Database

Especifica o nome do banco de dados do serviço vinculado.

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

-DataFactory

Especifica um objeto PSDataFactory . Esse cmdlet criptografa dados para o data factory especificado por esse parâmetro.

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

-DataFactoryName

Especifica o nome de um data factory. Esse cmdlet criptografa dados para o data factory especificado por esse parâmetro.

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure

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

-GatewayName

Especifica o nome do gateway. Esse cmdlet criptografa dados para o gateway especificado por esse parâmetro.

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

-NonCredentialValue

Especifica a parte não credencial da cadeia de conexão ODBC (Open Database Connectivity). Esse parâmetro é aplicável somente para o serviço vinculado ODBC.

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

-ResourceGroupName

Especifica o nome de um grupo de recursos do Azure. Esse cmdlet criptografa dados para o grupo especificado por esse parâmetro.

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

-Server

Especifica o nome do servidor do serviço vinculado.

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

-Type

Especifica o tipo de serviço vinculado. Esse cmdlet criptografa dados para o tipo de serviço vinculado especificado por esse parâmetro. Os valores aceitáveis para esse parâmetro são:

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

Especifica o valor a ser criptografado. Para um serviço vinculado do SQL Server local e um serviço vinculado Oracle local, use uma cadeia de conexão. Para um serviço vinculado ODBC local, use a parte de credenciais da cadeia de conexão. Para o serviço vinculado do sistema de arquivos local, se o sistema de arquivos for local para o computador gateway, use Local ou localhost e, se o sistema de arquivos estiver em um servidor diferente do computador gateway, use \\nome_do_servidor.

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

Entradas

PSDataFactory

String

Saídas