Export-ODataEndpointProxy

  • Reference
Modul:
Microsoft.PowerShell.ODataUtils

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. Jakmile tato rutina vygeneruje modul, 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), akce bez cruD a manipulaci 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 podstatná jména nebo názvy sloves rutin tak, aby odpovídaly pokynům pro pojmenování rutin prostředí Windows PowerShell, můžete soubor upravit.

Každá rutina v vygenerovaném modulu musí obsahovat parametr Připojení ionURI, 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 parametru OutputModule . Pro hodnotu parametru ResourceNameMapping poskytuje příkaz hashtable, který mapuje název kolekce prostředků na požadované podstatné jméno pro sadu rutin. V tomto příkladu je název kolekce prostředků a merchem je podstatné jméno. Pokud chcete povolit připojení k jiným webům než SSL, na rozdíl od PROTOKOLU HTTPS, přidejte parametr AllowUnsecure Připojení ion.

Parametry

-AllowClobber

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

Type:SwitchParameter
Position:10
Default value:None
Required:False
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
Required:False
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
Required:False
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
Required: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
Required:False
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á systém 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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-CustomData

Určuje hashovací tabulku vlastních dat.

Type:Hashtable
Position:9
Default value:None
Required:False
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
Required:False
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
Required:False
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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OutputModule

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

Tato rutina zkopíruje binární modul, manifest modulu a formátovací soubor (pokud je k dispozici) do zadané složky. Pokud zadáte pouze název modulu, Export-ODataEndpointProxy uloží 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
Required:True
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 klíčem název kolekce prostředků. Požadovaná podstatná jméno rutiny je hodnota.

Například v tabulce @{Products = 'Merchandise'}hash je products název kolekce prostředků, který slouží jako klíč. Merchem je výsledné jméno rutiny. Vygenerované názvy rutin nemusí odpovídat pokynům pro pojmenování rutin prostředí Windows PowerShell. Soubor CDXML prostředku můžete upravit tak, aby po vytvoření 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
Required:False
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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Uri

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

Type:String
Position:0
Default value:None
Required:True
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False