Export-ODataEndpointProxy

  • Referencia
Módulo:
Microsoft.PowerShell.ODataUtils

Genera un módulo que contiene cmdlets para administrar un punto de conexión de OData.

Syntax

Export-ODataEndpointProxy
      [-Uri] <String>
      [-OutputModule] <String>
      [[-MetadataUri] <String>]
      [[-Credential] <PSCredential>]
      [[-CreateRequestMethod] <String>]
      [[-UpdateRequestMethod] <String>]
      [[-CmdletAdapter] <String>]
      [[-ResourceNameMapping] <Hashtable>]
      [-Force]
      [[-CustomData] <Hashtable>]
      [-AllowClobber]
      [-AllowUnsecureConnection]
      [[-Headers] <Hashtable>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El Export-ODataEndpointProxy cmdlet usa los metadatos de un punto de conexión de OData para generar un módulo que contiene cmdlets que puede usar para administrar ese punto de conexión de OData. El módulo se basa en CDXML. Una vez que este cmdlet genera el módulo, guarda ese módulo en la ruta de acceso y el nombre de archivo especificados por el parámetro OutputModule .

Export-ODataEndpointProxy genera cmdlets para operaciones de creación, lectura, actualización y eliminación (CRUD), acciones que no son CRUD y manipulación de asociaciones.

Export-ODataEndpointProxy genera un archivo CDXML por recurso de punto de conexión. Puede editar estos archivos CDXML una vez generado el módulo. Por ejemplo, si desea cambiar los nombres de nombre o verbo de los cmdlets para que se alineen con las directrices de nomenclatura de cmdlets de Windows PowerShell, puede modificar el archivo.

Cada cmdlet de un módulo generado debe incluir un parámetro Conectar ionURI para conectarse al punto de conexión que administra el módulo.

Ejemplos

Ejemplo 1: Generación de un módulo para administrar un punto de conexión de servicio web minorista

PS C:\> Export-ODataEndpointProxy -Uri 'http://services.odata.org/v3/(S(snyobsk1hhutkb2yulwldgf1))/odata/odata.svc' -MetadataUri 'http://services.odata.org/v3/(S(snyobsk1hhutkb2yulwldgf1))/odata/odata.svc/$metadata' -AllowUnsecureConnection -OutputModule 'C:\Users\user\GeneratedScript.psm1' -ResourceNameMapping @{Products = 'Merchandise'}

Este comando genera un módulo para administrar un punto de conexión de servicio comercial. El comando especifica el URI del punto de conexión y el URI de los metadatos del punto de conexión. El comando también proporciona una ruta de acceso de salida y un nombre del módulo de script como valor del parámetro OutputModule . Para el valor del parámetro ResourceNameMapping , el comando proporciona una tabla hash que asigna el nombre de la colección de recursos al nombre deseado para el conjunto de cmdlets. En este ejemplo, Products es el nombre de la colección de recursos y La mercancía es el nombre. Para permitir conexiones a sitios que no son SSL, HTTP, en lugar de HTTPS, agregue el parámetro AllowUnsecure Conectar ion.

Parámetros

-AllowClobber

Indica que este cmdlet reemplaza a un módulo existente.

Type:SwitchParameter
Position:10
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AllowUnsecureConnection

Indica que este módulo puede conectarse a los URI que no están protegidos por SSL. El módulo puede administrar sitios HTTP además de sitios HTTPS.

Type:SwitchParameter
Position:11
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-CmdletAdapter

Especifica el adaptador de cmdlet. Los valores aceptables para este parámetro son: ODataAdapter y NetworkControllerAdapter.

Type:String
Accepted values:ODataAdapter, NetworkControllerAdapter, ODataV4Adapter
Position:6
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CreateRequestMethod

Especifica el método de solicitud. Los valores aceptables para este parámetro son: PUT, POST y PATCH.

Type:String
Accepted values:Put, Post, Patch
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Credential

Especifica una cuenta de usuario que tiene acceso al punto de conexión de OData. El valor predeterminado es el usuario actual. Si un equipo remoto ejecuta Windows Vista o una versión posterior del sistema operativo Windows, el cmdlet le pedirá credenciales.

Type:PSCredential
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-CustomData

Especifica una tabla hash de datos personalizados.

Type:Hashtable
Position:9
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Force

Indica que este cmdlet sobrescribe un módulo generado existente con el mismo nombre en una carpeta existente Modules .

Type:SwitchParameter
Position:8
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Headers

Especifica los encabezados de la solicitud web. Especifique una tabla hash o un diccionario.

Type:Hashtable
Position:12
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MetadataUri

Especifica el URI de los metadatos del punto de conexión.

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OutputModule

Especifica la ruta de acceso y el nombre del módulo en el que este cmdlet guarda el módulo generado de comandos proxy.

Este cmdlet copia un módulo binario, un manifiesto de módulo y un archivo de formato, si procede, en la carpeta especificada. Si especifica solo el nombre del módulo, Export-ODataEndpointProxy guarda el módulo en la $HOME\Documents\WindowsPowerShell\Modules carpeta . Si especifica una ruta de acceso, el cmdlet crea la carpeta del módulo en esa ruta de acceso.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceNameMapping

Especifica una tabla hash que contiene asignaciones que permiten personalizar los cmdlets generados. En esta tabla hash, el nombre de la colección de recursos es la clave. El nombre del cmdlet deseado es el valor.

Por ejemplo, en la tabla @{Products = 'Merchandise'}hash , Products es el nombre de la colección de recursos que actúa como clave. La mercancía es el nombre del cmdlet resultante. Es posible que los nombres de cmdlet generados no se alineen con las directrices de nomenclatura de cmdlets de Windows PowerShell. Puede modificar el archivo CDXML de recursos para cambiar los nombres de cmdlet después de que este cmdlet cree el módulo. Para obtener más información, vea Instrucciones de desarrollo fuertemente fomentadas.

Type:Hashtable
Position:7
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-UpdateRequestMethod

Especifica el método de solicitud de actualización. Los valores aceptables para este parámetro son: PUT, POST y PATCH.

Type:String
Accepted values:Put, Post, Patch
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Uri

Especifica el URI del punto de conexión.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False