Partilhar via

New-AzDataFactoryLinkedService

Módulo:
Az.DataFactory Module

Vincula um armazenamento de dados ou um serviço de nuvem a um Azure Data Factory.

Sintaxe

ByFactoryName (Padrão) 

New-AzDataFactoryLinkedService
    [-DataFactoryName] <String>
    [[-Name] <String>]
    [-File] <String>
    [-ResourceGroupName] <String>
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByFactoryObject 

New-AzDataFactoryLinkedService
    [-DataFactory] <PSDataFactory>
    [[-Name] <String>]
    [-File] <String>
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrição

O cmdlet New-AzDataFactoryLinkedService vincula um armazenamento de dados ou um serviço de nuvem ao Azure Data Factory. Se você especificar um nome para um serviço vinculado que já existe, esse cmdlet solicitará a confirmação antes de substituir o serviço vinculado. Se você especificar o parâmetro Force , o cmdlet substituirá o serviço vinculado existente sem confirmação. Execute essas operações na seguinte ordem:

  • Crie uma fábrica de dados.
  • Criar serviços ligados.
  • Crie conjuntos de dados.
  • Crie uma pipeline.

Exemplos

Exemplo 1: Criar um serviço vinculado

New-AzDataFactoryLinkedService -ResourceGroupName "ADF" -DataFactoryName "WikiADF" -Name "LinkedServiceCuratedWikiData" -File "C:\\samples\\WikiSample\\LinkedServiceCuratedWikiData.json" | Format-List

LinkedServiceName : LinkedServiceCuratedWikiData
ResourceGroupName : ADF
DataFactoryName   : WikiADF
Properties        : Microsoft.DataFactories.AzureStorageLinkedService

Este comando cria um serviço vinculado chamado LinkedServiceCuratedWikiData na fábrica de dados chamada WikiADF. Este serviço vinculado vincula um repositório de blob do Azure especificado no arquivo à fábrica de dados chamada WikiADF. O comando passa o resultado para o cmdlet Format-List usando o operador de pipeline. Esse cmdlet do Windows PowerShell formata os resultados. Para obter mais informações, digite Get-Help Format-List.

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:False
Suporta curingas:False
DontShow:False
Pseudónimos:Cf.

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-DataFactory

Especifica um objeto PSDataFactory . Este cmdlet cria um serviço vinculado para a fábrica de dados especificada por esse parâmetro.

Propriedades dos parâmetros

Tipo:PSDataFactory
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

ByFactoryObject
Posição:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-DataFactoryName

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

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

ByFactoryName
Posição:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes: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
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-File

Especifica o caminho completo do arquivo JSON (JavaScript Object Notation) que contém a descrição do serviço vinculado.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:3
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Force

Indica que esse cmdlet substitui um serviço vinculado existente sem solicitar confirmação.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica o nome do serviço vinculado a ser criado.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:2
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-ResourceGroupName

Especifica o nome de um grupo de recursos do Azure. Este cmdlet cria um serviço vinculado para o grupo especificado por esse parâmetro.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

ByFactoryName
Posição:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:False
Suporta curingas:False
DontShow:False
Pseudónimos:Wi

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes: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

PSLinkedService

Notas

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