New-AzDataFactoryEncryptValue

  • Référence
Module:
Az.DataFactory

Chiffre les données sensibles.

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

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
Accepted values:Windows, Basic, Anonymous
Position:6
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Database

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

Type:String
Position:8
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NonCredentialValue

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

Type:String
Position:5
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Server

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

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

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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

PSDataFactory

String

Sorties

String

Notes

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