Export-ODataEndpointProxy

生成一个模块,其中包含用于管理 OData 终结点的 cmdlet。

语法

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

说明

Export-ODataEndpointProxy cmdlet 使用 OData 终结点的元数据来生成一个模块,其中包含可用于管理该 OData 终结点的 cmdlet。 该模块基于 CDXML。 在此 cmdlet 生成模块后,它将该模块保存到 OutputModule 参数指定的路径和文件名。

Export-ODataEndpointProxy 生成用于创建、读取、更新和删除(CRUD)操作、非 CRUD 操作和关联操作的 cmdlet。

Export-ODataEndpointProxy 为每个终结点资源生成一个 CDXML 文件。 生成模块后,可以编辑这些 CDXML 文件。 例如,如果要更改 cmdlet 的名词或谓词名称,以便与 Windows PowerShell cmdlet 命名准则保持一致,可以修改该文件。

生成的模块中的每个 cmdlet 都必须包含 ConnectionURI 参数才能连接到模块管理的终结点。

示例

示例 1:生成用于管理零售 Web 服务终结点的模块

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'}

此命令生成用于管理零售服务终结点的模块。 该命令指定终结点的 URI 和终结点元数据的 URI。 该命令还提供输出路径和脚本模块名称作为 OutputModule 参数的值。 对于 ResourceNameMapping 参数的值,该命令提供一个哈希表,用于将资源集合名称映射到 cmdlet 集所需的名词。 在此示例中,Products 是资源集合名称,Merchandise 是名词。 若要允许连接到非 SSL 站点 HTTP,而不是 HTTPS,请添加 AllowUnsecureConnection 参数。

参数

-AllowClobber

指示此 cmdlet 替换现有模块。

类型:SwitchParameter
Position:10
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-AllowUnsecureConnection

指示此模块可以连接到不受 SSL 保护的 URI。 除了 HTTPS 站点之外,该模块还可以管理 HTTP 站点。

类型:SwitchParameter
Position:11
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-CmdletAdapter

指定 cmdlet 适配器。 此参数的可接受值为:ODataAdapter 和 NetworkControllerAdapter。

类型:String
接受的值:ODataAdapter, NetworkControllerAdapter, ODataV4Adapter
Position:6
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-CreateRequestMethod

指定请求方法。 此参数的可接受值为:PUT、POST 和 PATCH。

类型:String
接受的值:Put, Post, Patch
Position:4
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Credential

指定有权访问 OData 终结点的用户帐户。 默认值为当前用户。 如果远程计算机运行 Windows Vista 或更高版本的 Windows 操作系统,则 cmdlet 会提示你输入凭据。

类型:PSCredential
Position:3
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-CustomData

指定自定义数据的哈希表。

类型:Hashtable
Position:9
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Force

指示此 cmdlet 覆盖现有 Modules 文件夹中同名的现有生成模块。

类型:SwitchParameter
Position:8
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Headers

指定 Web 请求的标头。 输入哈希表或字典。

类型:Hashtable
Position:12
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-MetadataUri

指定终结点元数据的 URI。

类型:String
Position:2
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-OutputModule

指定此 cmdlet 将生成的代理命令模块保存到的路径和模块名称。

此 cmdlet 将二进制模块、模块清单和格式设置文件(如果适用)复制到指定文件夹。 如果仅指定模块的名称,Export-ODataEndpointProxy 会将模块保存在 $HOME\Documents\WindowsPowerShell\Modules 文件夹中。 如果指定路径,则 cmdlet 会在该路径中创建模块文件夹。

类型:String
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-ResourceNameMapping

指定一个哈希表,其中包含用于自定义生成的 cmdlet 的映射。 在此哈希表中,资源集合名称是键。 所需的 cmdlet 名词是值。

例如,在哈希表 @{Products = 'Merchandise'} 中,Products 是用作键的资源集合名称。 Merchandise 是生成的 cmdlet 名词。 生成的 cmdlet 名称可能与 Windows PowerShell cmdlet 命名准则不一致。 可以修改资源 CDXML 文件,以在此 cmdlet 创建模块后更改 cmdlet 名称。 有关详细信息,请参阅强烈建议的开发指南

类型:Hashtable
Position:7
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-UpdateRequestMethod

指定更新请求方法。 此参数的可接受值为:PUT、POST 和 PATCH。

类型:String
接受的值:Put, Post, Patch
Position:5
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Uri

指定终结点的 URI。

类型:String
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False