Export-ODataEndpointProxy

Vygeneruje modul, který obsahuje rutiny pro správu koncového bodu 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

Rutina Export-ODataEndpointProxy používá metadata koncového bodu OData k vygenerování modulu, který obsahuje rutiny, které můžete použít ke správě tohoto koncového bodu OData. Modul je založený na CDXML. Po vygenerování tohoto modulu uloží tento modul do cesty a názvu souboru určeného parametrem OutputModule .

Export-ODataEndpointProxy generuje rutiny pro operace vytvoření, čtení, aktualizace a odstranění (CRUD), akcí bez CRUD a manipulace s přidružením.

Export-ODataEndpointProxy vygeneruje jeden soubor CDXML na prostředek koncového bodu. Tyto soubory CDXML můžete upravit po vygenerování modulu. Pokud například chcete změnit jmenné jméno nebo názvy sloves rutin tak, aby odpovídaly pokynům pro pojmenování rutin Windows PowerShell, můžete soubor upravit.

Každá rutina v vygenerovaném modulu musí obsahovat parametr ConnectionURI , aby se mohl připojit ke koncovému bodu, který modul spravuje.

Příklady

Příklad 1: Vygenerování modulu pro správu koncového bodu maloobchodní webové služby

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

Tento příkaz vygeneruje modul pro správu koncového bodu maloobchodní služby. Příkaz určuje identifikátor URI koncového bodu a identifikátor URI metadat koncového bodu. Příkaz také poskytuje výstupní cestu a název modulu skriptu jako hodnotu outputModule parametru. Pro hodnotu parametru ResourceNameMapping poskytuje příkaz hashtable, který mapuje název kolekce prostředků na požadované jméno pro sadu rutin. V tomto příkladu je název kolekce zdrojů a Zboží je jmenné jméno. Pokud chcete povolit připojení k webům bez SSL, http na rozdíl od HTTPS přidejte parametr AllowUnsecureConnection .

Parametry

-AllowClobber

Označuje, že tato rutina nahrazuje existující modul.

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

-AllowUnsecureConnection

Označuje, že se tento modul může připojit k identifikátorům URI, které nejsou zabezpečené protokolem SSL. Modul může spravovat weby HTTP kromě webů HTTPS.

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

-CmdletAdapter

Určuje adaptér rutiny. Přijatelné hodnoty pro tento parametr jsou: ODataAdapter a NetworkControllerAdapter.

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-CreateRequestMethod

Určuje metodu požadavku. Přijatelné hodnoty pro tento parametr jsou: PUT, POST a PATCH.

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

-Credential

Určuje uživatelský účet, který má přístup ke koncovému bodu OData. Výchozí hodnota je aktuální uživatel. Pokud vzdálený počítač používá windows Vista nebo novější verzi operačního systému Windows, rutina vás vyzve k zadání přihlašovacích údajů.

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

-CustomData

Určuje hashovací tabulku vlastních dat.

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

-Force

Označuje, že tato rutina přepíše existující vygenerovaný modul se stejným názvem v existující Modules složce.

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

-Headers

Určuje hlavičky webového požadavku. Zadejte tabulku hash nebo slovník.

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

-MetadataUri

Určuje identifikátor URI metadat koncového bodu.

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

-OutputModule

Určuje cestu a název modulu, do kterého tato rutina ukládá vygenerovaný modul příkazů proxy.

Tato rutina zkopíruje binární modul, manifest modulu a formátovací soubor, pokud je to možné, do zadané složky. Pokud zadáte jenom název modulu, Export-ODataEndpointProxy uloží tento modul do $home\Documents\WindowsPowerShell\Modules složky. Pokud zadáte cestu, rutina v této cestě vytvoří složku modulu.

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

-ResourceNameMapping

Určuje hashovací tabulku, která obsahuje mapování, která umožňují přizpůsobit vygenerované rutiny. V této hashtable je název kolekce prostředků klíč. Požadované jméno rutiny je hodnota.

Například v tabulce @{Products = 'Merchandise'}hash jsou produkty název kolekce prostředků, který slouží jako klíč. Zboží je výsledné jmenné jméno rutiny. Vygenerované názvy rutin nemusí být v souladu s Windows PowerShell pokyny pro pojmenování rutin. Soubor CDXML prostředku můžete upravit tak, aby po vytvoření tohoto modulu změnil názvy rutin. Další informace najdete v tématu Pokyny pro vývoj se silnými doporučeními.

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

-UpdateRequestMethod

Určuje metodu žádosti o aktualizaci. Přijatelné hodnoty pro tento parametr jsou: PUT, POST a PATCH.

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

-Uri

Určuje identifikátor URI koncového bodu.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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