Export-ODataEndpointProxy

模組:: Microsoft.PowerShell.ODataUtils Module

產生模組，其中包含用來管理 OData 端點的 Cmdlet。

語法

Default (預設值)

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

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 是資源集合名稱和商品是名詞。若要允許連線到非 SSL 網站，HTTP，而不是 HTTPS，請新增 AllowUnsecureConnection 參數。

參數

-AllowClobber

表示此 Cmdlet 會取代現有的模組。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	10
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-AllowUnsecureConnection

指出此模組可以連線到未受 SSL 保護的 URI。此模組除了 HTTPS 網站之外，還可以管理 HTTP 網站。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	11
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-CmdletAdapter

指定 Cmdlet 配接器。此參數可接受的值為：ODataAdapter 和 NetworkControllerAdapter。

參數屬性

類型:	String
預設值:	None
接受的值:	ODataAdapter, NetworkControllerAdapter, ODataV4Adapter
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	6
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	cf

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-CreateRequestMethod

指定要求方法。此參數可接受的值為：PUT、POST 和 PATCH。

參數屬性

類型:	String
預設值:	None
接受的值:	Put, Post, Patch
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	4
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Credential

指定可存取 OData 端點的用戶帳戶。預設值為目前的使用者。如果遠端電腦執行 Windows Vista 或更新版本的 Windows 作業系統，Cmdlet 會提示您輸入認證。

參數屬性

類型:	PSCredential
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	3
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-CustomData

指定自訂數據的哈希表。

參數屬性

類型:	Hashtable
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	9
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Force

指出此 Cmdlet 會覆寫現有 Modules 資料夾中相同名稱的現有產生的模組。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	8
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Headers

指定 Web 要求的標頭。輸入哈希表或字典。

參數屬性

類型:	Hashtable
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	12
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-MetadataUri

指定端點元數據的 URI。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	2
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-OutputModule

指定此 Cmdlet 儲存所產生 Proxy 命令模組的路徑和模組名稱。

如果適用，此 Cmdlet 會將二進位模組、模組指令清單和格式化檔案複製到指定的資料夾。如果您只指定模組的名稱，Export-ODataEndpointProxy 會將模組儲存在 [$HOME\Documents\WindowsPowerShell\Modules] 資料夾中。如果您指定路徑，Cmdlet 會在該路徑中建立模組資料夾。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	1
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-ResourceNameMapping

指定哈希表，其中包含可讓您自定義所產生 Cmdlet 的對應。在此哈希表中，資源集合名稱是索引鍵。所需的 Cmdlet 名詞是值。

例如，在哈希表 @{Products = 'Merchandise'}中，Products 是做為索引鍵的資源集合名稱。商品是產生的 Cmdlet 名詞。產生的 Cmdlet 名稱可能不符合 Windows PowerShell Cmdlet 命名指導方針。您可以在此 Cmdlet 建立模組之後，修改資源 CDXML 檔案來變更 Cmdlet 名稱。如需詳細資訊，請參閱強烈建議開發指導方針。

參數屬性

類型:	Hashtable
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	7
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-UpdateRequestMethod

指定更新要求方法。此參數可接受的值為：PUT、POST 和 PATCH。

參數屬性

類型:	String
預設值:	None
接受的值:	Put, Post, Patch
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	5
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Uri

指定端點的 URI。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	0
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。指令未執行。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	無線

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

意見反應

此頁面對您有幫助嗎？

共用方式為

Export-ODataEndpointProxy

語法

Default (預設值)

Description

範例

範例 1：產生模組來管理零售 Web 服務端點

參數

-AllowClobber

參數屬性

參數集

-AllowUnsecureConnection

參數屬性

參數集

-CmdletAdapter

參數屬性

參數集

-Confirm

參數屬性

參數集

-CreateRequestMethod

參數屬性

參數集

-Credential

參數屬性

參數集

-CustomData

參數屬性

參數集

-Force

參數屬性

參數集

-Headers

參數屬性

參數集

-MetadataUri

參數屬性

參數集

-OutputModule

參數屬性

參數集

-ResourceNameMapping

參數屬性

參數集

-UpdateRequestMethod

參數屬性

參數集

-Uri

參數屬性

參數集

-WhatIf

參數屬性

參數集

CommonParameters

相關連結

意見反應