Partilhar via

New-AzDataFactoryEncryptValue

Módulo:
Az.DataFactory Module

Criptografa dados confidenciais.

Sintaxe

ByFactoryName (Predefinição) 

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

Description

O cmdlet New-AzDataFactoryEncryptValue encripta dados sensíveis, como uma palavra-passe ou uma Microsoft SQL Server cadeia de ligação, e devolve um valor encriptado.

Exemplos

Exemplo 1: Encriptar uma cadeia de ligação não 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

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

Exemplo 2: Encriptar uma cadeia de ligação não ODBC que use 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

O primeiro comando usa ConvertTo-SecureString para converter o cadeia de ligação especificado num objeto secure string, e depois 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 em $Value e $Credential para o data factory especificado, gateway, grupo de recursos e tipo de serviço vinculado.

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

$Value = ConvertTo-SecureString "******" -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 recolher o Windows authentication (nome de utilizador e palavra-passe), e depois armazena esse objeto PSCredential na variável $Credential. O terceiro comando cria um valor criptografado para o objeto armazenado em $Value e $Credential para o data factory especificado, gateway, grupo de recursos e tipo de serviço vinculado.

Exemplo 4: Criptografar credenciais para o serviço vinculado 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"

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, pode usar o comando Get-Credential para recolher Windows authentication (nome de utilizador e palavra-passe) e depois armazenar o objeto PSCredential devolvido na variável $credential, como mostrado nos exemplos anteriores. O comando New-AzDataFactoryEncryptValue cria um valor criptografado para o objeto armazenado no $Credential para o data factory especificado, gateway, grupo de recursos e tipo de serviço vinculado.

Exemplo 5: Criptografar credenciais para o serviço vinculado 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

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 em $Value para o data factory especificado, gateway, grupo de recursos e tipo de serviço vinculado.

Parâmetros

-AuthenticationType

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

  • Windows
  • Básico
  • Anónimos.

Propriedades dos parâmetros

Tipo:String
Default value:None
Valores aceites:Windows, Basic, Anonymous
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:6
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Credential

Especifica as credenciais de Windows authentication (nome de utilizador e palavra-passe) a serem usadas. Este cmdlet criptografa os dados de credenciais especificados aqui.

Propriedades dos parâmetros

Tipo:PSCredential
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:3
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Database

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:8
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DataFactory

Especifica um objeto PSDataFactory . Este cmdlet criptografa dados para a fábrica de dados especificada por esse parâmetro.

Propriedades dos parâmetros

Tipo:PSDataFactory
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ByFactoryObject
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-DataFactoryName

Especifica o nome de um data factory. Este cmdlet criptografa dados para a fábrica de dados especificada por esse parâmetro.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ByFactoryName
Position:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-DefaultProfile

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

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-GatewayName

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-NonCredentialValue

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:5
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ResourceGroupName

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ByFactoryName
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Server

Especifica o nome do servidor do serviço vinculado.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:7
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Type

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

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Valores aceites:OnPremisesSqlLinkedService, OnPremisesFileSystemLinkedService, OnPremisesOracleLinkedService, OnPremisesOdbcLinkedService, OnPremisesPostgreSqlLinkedService, OnPremisesTeradataLinkedService, OnPremisesMySQLLinkedService, OnPremisesDB2LinkedService, OnPremisesSybaseLinkedService, HdfsLinkedService
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:4
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Value

Especifica o valor a ser criptografado. Para um serviço ligado SQL Server local e um serviço ligado Oracle local, use uma cadeia de ligação. Para um serviço ligado ODBC on-premiss, use a parte de credencial da cadeia de ligaçã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 \\servername.

Propriedades dos parâmetros

Tipo:SecureString
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:1
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

PSDataFactory

String

Saídas

String

Notas

  • Palavras-chave: azure, azurerm, arm, resource, management, manager, data, factories