Compartir a través de

New-AzDataFactoryLinkedService

Módulo:
Az.DataFactory Module

Vincula un almacén de datos o un servicio en la nube a una instancia de Azure Data Factory.

Sintaxis

ByFactoryName (valor predeterminado) 

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

Description

El cmdlet New-AzDataFactoryLinkedService vincula un almacén de datos o un servicio en la nube a Azure Data Factory. Si especifica un nombre para un servicio vinculado que ya existe, este cmdlet le pedirá confirmación antes de reemplazar el servicio vinculado. Si especifica el parámetro Force , el cmdlet reemplaza el servicio vinculado existente sin confirmación. Realice estas operaciones en el orden siguiente:

  • Creación de una factoría de datos.
  • Cree servicios vinculados.
  • Cree conjuntos de datos.
  • Crear una canalización.

Ejemplos

Ejemplo 1: Creación de un servicio 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 crea un servicio vinculado denominado LinkedServiceCuratedWikiData en la factoría de datos denominada WikiADF. Este servicio vinculado vincula un almacén de blobs de Azure especificado en el archivo a la factoría de datos denominada WikiADF. El comando pasa el resultado al cmdlet Format-List mediante el operador de canalización. Ese cmdlet de Windows PowerShell da formato a los resultados. Para obtener más información, escriba Get-Help Format-List.

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DataFactory

Especifica un objeto PSDataFactory . Este cmdlet crea un servicio vinculado para la factoría de datos que especifica este parámetro.

Propiedades de parámetro

Tipo:PSDataFactory
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByFactoryObject
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DataFactoryName

Especifica el nombre de una factoría de datos. Este cmdlet crea un servicio vinculado para la factoría de datos que especifica este parámetro.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByFactoryName
Posición:1
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-File

Especifica la ruta de acceso completa del archivo de notación de objetos JavaScript (JSON) que contiene la descripción del servicio vinculado.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:3
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Force

Indica que este cmdlet reemplaza a un servicio vinculado existente sin solicitar confirmación.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Especifica el nombre del servicio vinculado que se va a crear.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:2
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ResourceGroupName

Especifica el nombre de un grupo de recursos de Azure. Este cmdlet crea un servicio vinculado para el grupo que especifica este parámetro.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByFactoryName
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

PSDataFactory

String

Salidas

PSLinkedService

Notas

  • Palabras clave: azure, azurerm, arm, resource, management, manager, data, factorys