Export-ODataEndpointProxy

  • Referencia
Modul:
Microsoft.PowerShell.ODataUtils

Létrehoz egy modult, amely parancsmagokat tartalmaz egy OData-végpont kezeléséhez.

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

A Export-ODataEndpointProxy parancsmag egy OData-végpont metaadataival hoz létre egy olyan modult, amely az OData-végpont kezeléséhez használható parancsmagokat tartalmaz. A modul a CDXML-en alapul. Miután ez a parancsmag létrehozta a modult, a modult az OutputModule paraméter által megadott elérési útra és fájlnévre menti.

Export-ODataEndpointProxy parancsmagokat hoz létre a létrehozási, olvasási, frissítési és törlési (CRUD) műveletekhez, a nem CRUD műveletekhez és a társítási manipulációhoz.

Export-ODataEndpointProxy végponterőforrásonként egy CDXML-fájlt hoz létre. Ezeket a CDXML-fájlokat a modul létrehozása után szerkesztheti. Ha például módosítani szeretné a parancsmagok főnevét vagy igenevét a Windows PowerShell-parancsmagok elnevezési irányelveinek megfelelően, módosíthatja a fájlt.

A generált modul minden parancsmagjának tartalmaznia kell egy Csatlakozás ionURI paramétert ahhoz a végponthoz való csatlakozáshoz, amelyet a modul kezel.

Példák

1. példa: Modul létrehozása kiskereskedelmi webszolgáltatás-végpont kezeléséhez

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

Ez a parancs létrehoz egy modult egy kiskereskedelmi szolgáltatásvégpont kezeléséhez. A parancs megadja a végpont URI-ját és a végpont metaadatainak URI-ját. A parancs egy kimeneti útvonalat és egy szkriptmodulnevet is biztosít az OutputModule paraméter értékeként. A ResourceNameMapping paraméter értékéhez a parancs egy kivonatolót biztosít, amely leképezi az erőforráscsoport nevét a parancsmagkészlet kívánt főnévére. Ebben a példában a Termékek az erőforrásgyűjtemény neve, az Áru pedig a főnév. A nem SSL-webhelyekhez való kapcsolatok engedélyezéséhez a HTTP a HTTPS helyett adja hozzá az AllowUnsecure Csatlakozás ion paramétert.

Paraméterek

-AllowClobber

Azt jelzi, hogy ez a parancsmag lecserél egy meglévő modult.

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

-AllowUnsecureConnection

Azt jelzi, hogy ez a modul olyan URI-khoz tud csatlakozni, amelyek nem SSL-védelemben vannak. A modul a HTTPS-webhelyek mellett HTTP-webhelyeket is képes kezelni.

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

-CmdletAdapter

A parancsmagadaptert adja meg. A paraméter elfogadható értékei a következők: ODataAdapter és NetworkControllerAdapter.

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

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-CreateRequestMethod

A kérelem metódusát adja meg. A paraméter elfogadható értékei a következők: PUT, POST és PATCH.

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

-Credential

Az OData-végponthoz hozzáféréssel rendelkező felhasználói fiókot határoz meg. Az alapértelmezett érték az aktuális felhasználó. Ha egy távoli számítógép Windows Vista rendszert vagy a Windows operációs rendszer egy későbbi kiadását futtatja, a parancsmag hitelesítő adatokat kér.

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

-CustomData

Egyéni adatok kivonattábláját adja meg.

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

-Force

Azt jelzi, hogy ez a parancsmag felülír egy azonos nevű, már létrehozott modult egy meglévő Modules mappában.

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

-Headers

Megadja a webes kérelem fejléceit. Adjon meg egy kivonattáblát vagy szótárt.

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

-MetadataUri

A végpont metaadatainak URI-ját adja meg.

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

-OutputModule

Megadja azt az elérési utat és modulnevet, amelyre a parancsmag menti a proxyparancsok generált modulját.

Ez a parancsmag egy bináris modult, moduljegyzéket és formázási fájlt másol, ha van ilyen, a megadott mappába. Ha csak a modul nevét adja meg, Export-ODataEndpointProxy a modult a $HOME\Documents\WindowsPowerShell\Modules mappába menti. Ha megad egy elérési utat, a parancsmag létrehozza a modulmappát az elérési úton.

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

-ResourceNameMapping

Olyan kivonatolót ad meg, amely megfeleltetéseket tartalmaz, amelyek lehetővé teszik a létrehozott parancsmagok testreszabását. Ebben a kivonatolóban az erőforráscsoport neve a kulcs. A kívánt parancsmag főnév az érték.

A kivonatoló táblában @{Products = 'Merchandise'}például a Termékek az erőforráscsoport neve, amely kulcsként szolgál. Az áru az eredményül kapott parancsmag főnév. Előfordulhat, hogy a létrehozott parancsmagnevek nem illenek a Windows PowerShell-parancsmag elnevezési irányelveihez. Az erőforrás CDXML-fájljának módosításával módosíthatja a parancsmagok nevét, miután ez a parancsmag létrehozta a modult. További információ: Erősen ajánlott fejlesztési irányelvek.

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

-UpdateRequestMethod

A frissítéskérési metódust adja meg. A paraméter elfogadható értékei a következők: PUT, POST és PATCH.

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

-Uri

A végpont URI-ját adja meg.

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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