Modules vereisen van instemming met licentieModules Requiring License Acceptance

SAMENVATTINGSYNOPSIS

Juridische afdelingen voor sommige uitgevers van de module vereist dat klanten expliciet de licentievoorwaarden accepteren voordat hun-module installeren vanuit PowerShell-galerie.Legal departments for some module publishers require that customers must explicitly accept the license before installing their module from PowerShell Gallery. Als een gebruiker wordt geïnstalleerd, bijgewerkt of een module met behulp van PowerShellGet, rechtstreeks of als een afhankelijkheid voor een ander item wordt opgeslagen en die module moet de gebruiker akkoord gaat met een licentie, moet de gebruiker aan ze de licentievoorwaarden accepteren of dat de bewerking is mislukt.If a user installs, updates, or saves a module using PowerShellGet, whether directly or as a dependency for another item, and that module requires the user to agree to a license, the user must indicate they accept the license or the operation fails.

Vereisten voor Modules publicerenPublish Requirements for Modules

Modules die u dat wilt gebruikers moeten akkoord gaan met licentievoorwaarden moeten volgende vereisten voldoen:Modules that would like to require users to accept license should fulfill following requirements:

  • PSData sectie van de module-manifest bevatten RequireLicenseAcceptance = $True.PSData section of module manifest should include RequireLicenseAcceptance = $True.
  • Module moet license.txt bestand in de hoofdmap bevatten.Module should contain license.txt file in root directory.
  • Module-manifest moet licentie Uri bevatten.Module manifest should contain License Uri.
  • Module moet worden gepubliceerd met PowerShellGet indeling versie 2.0 en hoger.Module should be published with PowerShellGet Format Version 2.0 and above.

Gevolgen voor de installatie/Save/Update-ModuleImpact on Install/Save/Update-Module

  • Cmdlets opslaan-installatie-Update wordt ondersteuning voor een nieuwe parameter – het AcceptLicense gedraagt zich alsof de gebruiker de licentievoorwaarden hebt gezien.Install/Save/Update cmdlets will support a new parameter –AcceptLicense that will behave as though the user saw the license.
  • Als RequiredLicenseAcceptance ingesteld op True is en – AcceptLicense niet is opgegeven, de gebruiker worden weergegeven de license.txt, en met gevraagd: "gaat u akkoord met deze licentievoorwaarden (Ja/Nee/YesToAll/NoToAll)".If RequiredLicenseAcceptance is True and –AcceptLicense is not specified, the user will be shown the license.txt, and prompted with: "Do you accept these license terms (Yes/No/YesToAll/NoToAll)".
    • Als de licentie is geaccepteerdIf the license is accepted
      • Opslaan-Module: de module wordt gekopieerd naar de gebruiker ' s systeemSave-Module: the module will be copied to the user's system
      • Installatie-Module: de module wordt gekopieerd naar de gebruiker ' s systeem naar de juiste map (op basis van bereik)Install-Module: the module will be copied to the user's system to the proper folder (based on scope)
      • Update-Module: de module wordt bijgewerkt.Update-Module: the module will be updated.
    • Als de licentie is geweigerd.If the license is declined.
      • Bewerking wordt geannuleerd.Operation will be cancelled.
  • Alle cmdlets wordt voor de metagegevens (requireLicenseAcceptance en versie-indeling) waarin staat dat de acceptatie van een licentie is vereist dat gecontroleerdAll cmdlets will check for the metadata(requireLicenseAcceptance and Format Version) that says a license acceptance is required
    • Als de versie van de indeling van de client is ouder dan 2.0, bewerking mislukken en vraag de gebruiker naar de client bijwerken.If format version of client is older than 2.0, operation will fail and ask the user to update the client.
    • Als de module is gepubliceerd met versie ouder is dan 2.0-indeling, worden requireLicenseAcceptance vlag genegeerd.If module was published with format version older than 2.0, requireLicenseAcceptance flag will be ignored.

Module-afhankelijkhedenModule Dependencies

  • Tijdens het opslaan-installatie-Update is-bewerking, als een afhankelijke module (iets anders is afhankelijk van de module) licentie acceptatie en vervolgens het gedrag van licentie acceptatie (boven vereist) vereist.During Install/Save/Update operation, if a dependent module(something else depends on the module) requires license acceptance, then the license acceptance behavior (above) will be required.
  • Als de moduleversie al wordt vermeld in de lokale catalogus als het wordt geïnstalleerd op het systeem, zouden we omzeilen licentie moet worden gecontroleerd.If the module version is already listed in the local catalog as being installed on the system, we would bypass the license checking.
  • Tijdens de bewerking opslaan-installatie-Update, als een afhankelijke module een licentie moet en de acceptatie van de licentie niet wordt uitgevoerd, zal de bewerking mislukken en volg normale processen voor het item kan niet opslaan-installatie-update.During Install/Save/Update operation, if a dependent module requires a license, and the license acceptance does not occur, the operation will fail and follow normal processes for the item failed to install/save/update.

    Gevolgen voor de - ForceImpact on -Force

Geven – Force is niet voldoende zijn voor het accepteren van een licentie.Specifying –Force is NOT sufficient to accept a license. – AcceptLicense is vereist voor de machtiging om te installeren.–AcceptLicense is required for permission to install. Als – Force is opgegeven, RequiredLicenseAcceptance is ingesteld op True, en – AcceptLicense niet is opgegeven, mislukt de bewerking.If –Force is specified, RequiredLicenseAcceptance is True, and –AcceptLicense is NOT specified, the operation will fail.

VOORBEELDENEXAMPLES

Voorbeeld 1: Update Module Manifest licentie acceptatie vereisenExample 1: Update Module Manifest to require license acceptance

PS C:\> Update-ModuleManifest -Path C:\modulemanifest.psd1 -RequireLicenseAcceptance

PrivateData = @{

    PSData = @{
        # Flag to indicate whether the module requires explicit user acceptance
        RequireLicenseAcceptance = $true
    } # End of PSData hashtable

 } # End of PrivateData hashtable

Deze opdracht werkt het manifestbestand en wordt de RequireLicenseAcceptance-vlag ingesteld op true.This command updates the manifest file and sets the RequireLicenseAcceptance flag to true.

Voorbeeld 2: Installeer Module vereisen licentie acceptatieExample 2: Install Module requiring license acceptance

PS C:\> Install-Module -Name ModuleRequireLicenseAcceptance

License Acceptance

License 2.0
Copyright (c) 2016 PowerShell Team
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software.

Do you accept the license terms for module 'ModuleRequireLicenseAcceptance'.
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): 

Deze opdracht geeft de licentie van license.txt bestand en vraagt de gebruiker de licentievoorwaarden accepteren.This command shows the license from license.txt file and prompts the user to accept the license.

Voorbeeld 3: Installatie Module vereisen licentie instemming met - AcceptLicenseExample 3: Install Module requiring license acceptance with -AcceptLicense

PS C:\> Install-Module -Name ModuleRequireLicenseAcceptance -AcceptLicense

Module is zonder een prompt te accepteren van de licentie geïnstalleerd.Module is installed without any prompt to accept license.

Voorbeeld 4: Installatie Module vereisen licentie instemming met - ForceExample 4: Install Module requiring license acceptance with -Force

PS C:\> Install-Module -Name ModuleRequireLicenseAcceptance -Force
PackageManagement\Install-Package : License Acceptance is required for module 'ModuleRequireLicenseAcceptance'. Please specify '-AcceptLicense' to perform this operation.
At C:\Program Files\WindowsPowerShell\Modules\PowerShellGet\1.1.3.3\PSModule.psm1:1837 char:21
+ ...          $null = PackageManagement\Install-Package @PSBoundParameters
+                      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : InvalidArgument: (Microsoft.Power....InstallPackage:InstallPackage) [Install-Package], E
   xception
    + FullyQualifiedErrorId : ForceAcceptLicense,Install-PackageUtility,Microsoft.PowerShell.PackageManagement.Cmdlets
   .InstallPackage

Voorbeeld 5: Installatie Module met afhankelijkheden vereisen van instemming met licentieExample 5: Install Module with dependencies requiring license acceptance

Module 'ModuleWithDependency', is afhankelijk van de module 'ModuleRequireLicenseAcceptance'.Module 'ModuleWithDependency' depends on module 'ModuleRequireLicenseAcceptance'. Gebruiker wordt gevraagd om een licentie accepteren.User is prompted to Accept License.

PS C:\> Install-Module -Name ModuleWithDependency

License Acceptance
MIT License 2.0
Copyright (c) 2016 PowerShell Team
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software.

Do you accept the license terms for module 'ModuleRequireLicenseAcceptance'.
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): 

Voorbeeld 6: Installatie Module met afhankelijkheden licentie acceptatie en -AcceptLicense vereisenExample 6: Install Module with dependencies requiring license acceptance and -AcceptLicense

Module 'ModuleWithDependency', is afhankelijk van de module 'ModuleRequireLicenseAcceptance'.Module 'ModuleWithDependency' depends on module 'ModuleRequireLicenseAcceptance'. Gebruiker niet gevraagd licentie accepteren omdat - AcceptLicense is opgegeven.User is not prompted to accept license as -AcceptLicense is specified.

PS C:\>  Install-Module -Name ModuleWithDependency -AcceptLicense

Voorbeeld 7: Vereisen van instemming van de licentie op een client die ouder zijn dan PSGetFormatVersion 2.0-module installerenExample 7: Install module requiring license acceptance on a client older than PSGetFormatVersion 2.0

PS C:\windows\system32> Install-Module -Name ModuleRequireLicenseAcceptance

WARNING: The specified module 'ModuleRequireLicenseAcceptance' with PowerShellGetFormatVersion '2.0' is not supported by the current version of PowerShellGet. Get the latest version of the PowerShellGet module to install this module, 'ModuleRequireLicenseAcceptance'.

Voorbeeld 8: Sla Module vereisen van instemming met licentieExample 8: Save Module requiring license acceptance

PS C:\> Save-Module -Name ModuleRequireLicenseAcceptance -Path C:\Saved

License Acceptance

License 2.0
Copyright (c) 2016 PowerShell Team
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software.

Do you accept the license terms for module 'ModuleRequireLicenseAcceptance'.
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): 

Deze opdracht geeft de licentie van license.txt bestand en vraagt de gebruiker de licentievoorwaarden accepteren.This command shows the license from license.txt file and prompts the user to accept the license.

Voorbeeld 9: Sla Module vereisen van instemming met AcceptLicense - licentieExample 9: Save Module requiring license acceptance with -AcceptLicense

PS C:\> Save-Module -Name ModuleRequireLicenseAcceptance -AcceptLicense -Path C:\Saved

Module is zonder een prompt te accepteren van de licentie opgeslagen.Module is saved without any prompt to accept license.

Voorbeeld 10: Update Module vereisen licentie acceptatieExample 10: Update Module requiring license acceptance

PS C:\> Update-Module -Name ModuleRequireLicenseAcceptance

License Acceptance

License 2.0
Copyright (c) 2016 PowerShell Team
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software.

Do you accept the license terms for module 'ModuleRequireLicenseAcceptance'.
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): 

Deze opdracht geeft de licentie van license.txt bestand en vraagt de gebruiker de licentievoorwaarden accepteren.This command shows the license from license.txt file and prompts the user to accept the license.

Voorbeeld 11: Module Update vereisen licentie instemming met - AcceptLicenseExample 11: Update Module requiring license acceptance with -AcceptLicense

PS C:\> Update-Module -Name ModuleRequireLicenseAcceptance -AcceptLicense

Module bijgewerkt zonder een prompt licentie accepteren.Module is updated without any prompt to accept license.

meer informatieMore details

Vereisen dat gebruikers van de licentie voor ScriptsRequire License Acceptance for Scripts

Acceptatie van de licentie-ondersteuning op PowerShellGallery vereistRequire License Acceptance support on PowerShellGallery

Vereisen dat gebruikers van de licentie op implementeren in Azure AutomationRequire License Acceptance on Deploy to Azure Automation