Sdílet prostřednictvím


Export-ODataEndpointProxy

Vygeneruje modul, který obsahuje rutiny pro správu koncového bodu OData.

Syntax

Default (Výchozí)

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), 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 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 parametru OutputModule. Pro hodnotu ResourceNameMapping parametr 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 Merche je podstatné jméno. Pokud chcete povolit připojení k webům bez SSL, na rozdíl od PROTOKOLU HTTPS, přidejte parametr AllowUnsecureConnection.

Parametry

-AllowClobber

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

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:10
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:11
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-CmdletAdapter

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

Vlastnosti parametru

Typ:String
Default value:None
Přípustné hodnoty:ODataAdapter, NetworkControllerAdapter, ODataV4Adapter
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:6
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:viz

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-CreateRequestMethod

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

Vlastnosti parametru

Typ:String
Default value:None
Přípustné hodnoty:Put, Post, Patch
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:4
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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ů.

Vlastnosti parametru

Typ:PSCredential
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:3
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-CustomData

Určuje hashovací tabulku vlastních dat.

Vlastnosti parametru

Typ:Hashtable
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:9
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Force

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

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:8
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Headers

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

Vlastnosti parametru

Typ:Hashtable
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:12
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-MetadataUri

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:2
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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 jenom název modulu, Export-ODataEndpointProxy modul uloží do složky $HOME\Documents\WindowsPowerShell\Modules. Pokud zadáte cestu, rutina v této cestě vytvoří složku modulu.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:1
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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 hash @{Products = 'Merchandise'}, Products je 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 důrazně doporučujeme pokyny pro vývoj.

Vlastnosti parametru

Typ:Hashtable
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:7
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-UpdateRequestMethod

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

Vlastnosti parametru

Typ:String
Default value:None
Přípustné hodnoty:Put, Post, Patch
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:5
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Uri

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:0
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Wi

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.