Поделиться через

New-AzDataFactoryEncryptValue

  • Ссылка
Модуль:
Az.DataFactory

Шифрует конфиденциальные данные.

Синтаксис

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

Описание

Командлет New-AzDataFactoryEncryptValue шифрует конфиденциальные данные, например пароль или строку подключения Microsoft SQL Server, и возвращает зашифрованное значение.

Примеры

Пример 1. Шифрование строки подключения, отличной от 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

Первая команда использует командлет ConvertTo-SecureString для преобразования указанной строки подключения в объект SecureString, а затем сохраняет этот объект в переменной $Value. Дополнительные сведения см. в Get-Help ConvertTo-SecureString. Допустимые значения: SQL Server или строка подключения Oracle. Вторая команда создает зашифрованное значение для объекта, хранящегося в $Value для указанной фабрики данных, шлюза, группы ресурсов и связанного типа службы.

Пример 2. Шифрование строки подключения, отличной от ODBC, которая использует проверку подлинности Windows.

$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

Первая команда использует ConvertTo-SecureString для преобразования указанной строки подключения в безопасный объект строки, а затем сохраняет этот объект в переменной $Value. Вторая команда использует командлет Get-Credential для сбора проверки подлинности Windows (имени пользователя и пароля), а затем сохраняет этот объект PSCredential в переменной $Credential. Дополнительные сведения см. в Get-Help Get-Credential. Третья команда создает зашифрованное значение для объекта, хранящегося в $Value и $Credential для указанной фабрики данных, шлюза, группы ресурсов и связанного типа службы.

Пример 3. Шифрование имени сервера и учетных данных для связанной службы файловой системы

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

Первая команда использует ConvertTo-SecureString для преобразования указанной строки в безопасную строку, а затем сохраняет этот объект в переменной $Value. Вторая команда использует get-Credential для сбора проверки подлинности Windows (имени пользователя и пароля), а затем сохраняет объект PSCredential в переменной $Credential. Третья команда создает зашифрованное значение для объекта, хранящегося в $Value и $Credential для указанной фабрики данных, шлюза, группы ресурсов и связанного типа службы.

Пример 4. Шифрование учетных данных для связанной службы 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"

Команда ConvertTo-SecureString преобразует указанную строку в безопасную строку. Команда New-Object создает объект PSCredential с помощью безопасных строк имени пользователя и пароля. Вместо этого можно использовать команду Get-Credential для сбора проверки подлинности Windows (имени пользователя и пароля), а затем сохранить возвращенный объект PSCredential в переменной $credential, как показано в предыдущих примерах. Команда New-AzDataFactoryEncryptValue создает зашифрованное значение для объекта, хранящегося в $Credential для указанной фабрики данных, шлюза, группы ресурсов и связанного типа службы.

Пример 5. Шифрование учетных данных для связанной службы 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

Команда ConvertTo-SecureString преобразует указанную строку в безопасную строку. Команда New-AzDataFactoryEncryptValue создает зашифрованное значение для объекта, хранящегося в $Value для указанной фабрики данных, шлюза, группы ресурсов и связанного типа службы.

Параметры

-AuthenticationType

Указывает тип проверки подлинности, используемый для подключения к источнику данных. Допустимые значения для этого параметра:

  • Виндоус
  • Основной
  • Анонимный.
Тип:String
Допустимые значения:Windows, Basic, Anonymous
Position:6
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Credential

Указывает используемые учетные данные проверки подлинности Windows (имя пользователя и пароль). Этот командлет шифрует указанные здесь данные учетных данных.

Тип:PSCredential
Position:3
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Database

Указывает имя базы данных связанной службы.

Тип:String
Position:8
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DataFactory

Указывает объект PSDataFactory. Этот командлет шифрует данные для фабрики данных, указанной этим параметром.

Тип:PSDataFactory
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DataFactoryName

Указывает имя фабрики данных. Этот командлет шифрует данные для фабрики данных, указанной этим параметром.

Тип:String
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure

Тип:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-GatewayName

Указывает имя шлюза. Этот командлет шифрует данные для шлюза, указанного этим параметром.

Тип:String
Position:2
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-NonCredentialValue

Указывает часть подключения Open Database Connectivity (ODBC) без учетных данных. Этот параметр применим только для связанной службы ODBC.

Тип:String
Position:5
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ResourceGroupName

Указывает имя группы ресурсов Azure. Этот командлет шифрует данные для группы, указанной этим параметром.

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Server

Указывает имя сервера связанной службы.

Тип:String
Position:7
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Type

Указывает тип связанной службы. Этот командлет шифрует данные для связанного типа службы, указанного этим параметром. Допустимые значения для этого параметра:

  • OnPremisesSqlLinkedService
  • OnPremisesFileSystemLinkedService
  • OnPremisesOracleLinkedService
  • OnPremisesOdbcLinkedService
  • OnPremisesPostgreSqlLinkedService
  • OnPremisesTeradataLinkedService
  • OnPremisesMySQLLinkedService
  • OnPremisesDB2LinkedService
  • OnPremisesSybaseLinkedService
Тип:String
Допустимые значения:OnPremisesSqlLinkedService, OnPremisesFileSystemLinkedService, OnPremisesOracleLinkedService, OnPremisesOdbcLinkedService, OnPremisesPostgreSqlLinkedService, OnPremisesTeradataLinkedService, OnPremisesMySQLLinkedService, OnPremisesDB2LinkedService, OnPremisesSybaseLinkedService, HdfsLinkedService
Position:4
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Value

Указывает значение для шифрования. Для локальной связанной службы SQL Server и локальной связанной службы Oracle используйте строку подключения. Для локальной связанной службы ODBC используйте часть учетных данных строки подключения. Для локальной связанной файловой системы, если файловая система является локальной на компьютере шлюза, используйте local или localhost, а если файловая система находится на сервере, отличном от компьютера шлюза, используйте \\servername.

Тип:SecureString
Position:1
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

Выходные данные

Примечания

  • Ключевые слова: azure, azurerm, arm, resource, management, manager, data, фабрики