Partager via

New-AzDataFactoryEncryptValue

  • Référence
Module:
Az.DataFactory

Chiffre les données sensibles.

Syntaxe

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

L’applet de commande New-AzDataFactoryEncryptValue chiffre les données sensibles, telles qu’un mot de passe ou un chaîne de connexion Microsoft SQL Server, et retourne une valeur chiffrée.

Exemples

Exemple 1 : Chiffrer un chaîne de connexion non 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

La première commande utilise l’applet de commande ConvertTo-SecureString pour convertir le chaîne de connexion spécifié en objet SecureString, puis stocke cet objet dans la variable $Value. Pour plus d'informations, voir Get-Help ConvertTo-SecureString. Valeurs autorisées : SQL Server ou Oracle chaîne de connexion. La deuxième commande crée une valeur chiffrée pour l’objet stocké dans $Value pour la fabrique de données, la passerelle, le groupe de ressources et le type de service lié spécifiés.

Exemple 2 : Chiffrer un chaîne de connexion non ODBC qui utilise Authentification 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

La première commande utilise ConvertTo-SecureString pour convertir le chaîne de connexion spécifié en objet de chaîne sécurisée, puis stocke cet objet dans la variable $Value. La deuxième commande utilise l’applet de commande Get-Credential pour collecter l’authentification Windows (nom d’utilisateur et mot de passe), puis stocke cet objet PSCredential dans la variable $Credential. Pour plus d'informations, voir Get-Help Get-Credential. La troisième commande crée une valeur chiffrée pour l’objet stocké dans $Value et $Credential pour la fabrique de données, la passerelle, le groupe de ressources et le type de service lié spécifiés.

Exemple 3 : Chiffrer le nom du serveur et les informations d’identification pour le service lié au système de fichiers

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

La première commande utilise ConvertTo-SecureString pour convertir la chaîne spécifiée en chaîne sécurisée, puis stocke cet objet dans la variable $Value. La deuxième commande utilise Get-Credential pour collecter le Authentification Windows (nom d’utilisateur et mot de passe), puis stocke cet objet PSCredential dans la variable $Credential. La troisième commande crée une valeur chiffrée pour l’objet stocké dans $Value et $Credential pour la fabrique de données, la passerelle, le groupe de ressources et le type de service lié spécifiés.

Exemple 4 : Chiffrer les informations d’identification pour le service lié 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"

La commande ConvertTo-SecureString convertit la chaîne spécifiée en chaîne sécurisée. La commande New-Object crée un objet PSCredential à l’aide des chaînes de nom d’utilisateur et de mot de passe sécurisées. Au lieu de cela, vous pouvez utiliser la commande Get-Credential pour collecter des Authentification Windows (nom d’utilisateur et mot de passe), puis stocker l’objet PSCredential retourné dans la variable $credential, comme indiqué dans les exemples précédents. La commande New-AzDataFactoryEncryptValue crée une valeur chiffrée pour l’objet stocké dans $Credential pour la fabrique de données, la passerelle, le groupe de ressources et le type de service lié spécifiés.

Exemple 5 : Chiffrer les informations d’identification pour le service lié 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

La commande ConvertTo-SecureString convertit la chaîne spécifiée en chaîne sécurisée. La commande New-AzDataFactoryEncryptValue crée une valeur chiffrée pour l’objet stocké dans $Value pour la fabrique de données, la passerelle, le groupe de ressources et le type de service lié spécifiés.

Paramètres

-AuthenticationType

Spécifie le type d’authentification à utiliser pour se connecter à la source de données. Les valeurs valides pour ce paramètre sont :

  • Windows
  • De base
  • Anonyme.
Type:String
Valeurs acceptées:Windows, Basic, Anonymous
Position:6
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Credential

Spécifie les informations d’identification Authentification Windows (nom d’utilisateur et mot de passe) à utiliser. Cette applet de commande chiffre les données d’informations d’identification que vous spécifiez ici.

Type:PSCredential
Position:3
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Database

Spécifie le nom de la base de données du service lié.

Type:String
Position:8
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DataFactory

Spécifie un objet PSDataFactory . Cette applet de commande chiffre les données de la fabrique de données spécifiée par ce paramètre.

Type:PSDataFactory
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DataFactoryName

Spécifie le nom d’une fabrique de données. Cette applet de commande chiffre les données de la fabrique de données spécifiée par ce paramètre.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-GatewayName

Spécifie le nom de la passerelle. Cette applet de commande chiffre les données de la passerelle spécifiée par ce paramètre.

Type:String
Position:2
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NonCredentialValue

Spécifie la partie non d’informations d’identification de l’chaîne de connexion ODBC (Open Database Connectivity). Ce paramètre s’applique uniquement au service lié ODBC.

Type:String
Position:5
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ResourceGroupName

Spécifie le nom d’un groupe de ressources Azure. Cette applet de commande chiffre les données du groupe spécifié par ce paramètre.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Server

Spécifie le nom du serveur du service lié.

Type:String
Position:7
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Type

Spécifie le type de service lié. Cette applet de commande chiffre les données du type de service lié spécifié par ce paramètre. Les valeurs valides pour ce paramètre sont :

  • OnPremisesSqlLinkedService
  • OnPremisesFileSystemLinkedService
  • OnPremisesOracleLinkedService
  • OnPremisesOdbcLinkedService
  • OnPremisesPostgreSqlLinkedService
  • OnPremisesTeradataLinkedService
  • OnPremisesMySQLLinkedService
  • OnPremisesDB2LinkedService
  • OnPremisesSybaseLinkedService
Type:String
Valeurs acceptées:OnPremisesSqlLinkedService, OnPremisesFileSystemLinkedService, OnPremisesOracleLinkedService, OnPremisesOdbcLinkedService, OnPremisesPostgreSqlLinkedService, OnPremisesTeradataLinkedService, OnPremisesMySQLLinkedService, OnPremisesDB2LinkedService, OnPremisesSybaseLinkedService, HdfsLinkedService
Position:4
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Value

Spécifie la valeur à chiffrer. Pour un service lié SQL Server local et un service lié Oracle local, utilisez un chaîne de connexion. Pour un service lié ODBC local, utilisez la partie d’informations d’identification du chaîne de connexion. Pour le service lié au système de fichiers local, si le système de fichiers est local sur l’ordinateur de passerelle, utilisez Local ou localhost, et si le système de fichiers se trouve sur un serveur différent de l’ordinateur de passerelle, utilisez \\servername.

Type:SecureString
Position:1
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

PSDataFactory

String

Sorties

String

Notes

  • Mots clés : azure, azurerm, arm, resource, management, manager, data, fabriques