Gerenciando proprietários do itemManaging Item Owners

A propriedade de um item na Galeria do PowerShell é definida pelo usuário que publicou o item na galeria.Ownership of an item in the PowerShell Gallery is defined by who published the item to the gallery. Às vezes, esses metadados precisam ser gerenciados além da publicação de item inicial, o que significa que os metadados de proprietário precisam ser mutáveis, enquanto o próprio item não é mutável.Sometimes this metadata needs to be managed beyond the initial item publishing, which means the owner metadata needs to be mutable while the item itself is not.

Todos os proprietários de item são pares.All item owners are peers. Isso significa que qualquer proprietário do item pode publicar uma nova versão de um item.This means any item owner can publish a new version of an item. Isso também significa que qualquer proprietário do item pode remover qualquer proprietário do item.It also means that any item owner can remove any other item owner. Nenhum proprietário tem mais autoridade que outros proprietários.No owner has more authority than other owners.

Configurando o proprietário inicial de um itemSetting an Item's Initial Owner

Quando um novo item é publicado na Galeria do PowerShell, o proprietário inicial é definido pelo usuário que publicou o item.When a new item is published to PowerShell Gallery, the initial owner is defined by the user that published the item. Isso é determinado pela chave de API de quem foi usada no cmdlet Publish-Module.This is determined by whose API key was used in the Publish-Module cmdlet.

Adicionando proprietáriosAdding Owners

Quando um item tiver sido publicado na Galeria do PowerShell, é fácil convidar outros usuários para se tornarem proprietários de um item.Once an item has been published to the PowerShell Gallery, it's easy to invite additional users to become owners of an item.

  1. Faça logon na Galeria do PowerShell com a conta que é o proprietário atual de um item.Log on to the PowerShell Gallery with the account that is the current owner of an item.
  2. Navegue até uma página de item usando a guia “Itens”, pesquisando ou clicando em seu nome de usuário e em Gerenciar Meus Itens.Navigate to an item page using the 'Items' tab, searching, or clicking your username and then Manage My Items.
  3. Quando estiver conectado como o proprietário de um item, você verá um link “Gerenciar proprietários” do lado esquerdo para clicar.When logged on as an item's owner, there is a 'Manage Owners' link on the left side to click.
  4. Insira o nome de usuário da pessoa a ser adicionada como um proprietário e clique em “Adicionar”.Enter the username of the person to add as an owner and click 'Add'.
  5. Em seguida, é enviado um email para o novo coproprietário, como um convite para que ele se torne um proprietário de um item.An email is then sent to the new co-owner, as an invitation to become an owner of an item.
  6. Depois que o usuário clicar no link, ele será um coproprietário completo com controle total sobre um item, incluindo a capacidade de remover outros usuários como proprietários.Once that user clicks the link, they are a full co-owner with full control over an item, including the ability to remove other users as owners.

OBSERVAÇÃO: até que o novo proprietário confirme a propriedade, ele não será listado como um proprietário de um item.NOTE: Until the new owner confirms ownership, they will not be listed as an owner of an item. Ao exibir a página Gerenciar Proprietários, você verá uma entrada “aprovação pendente” nos proprietários atuais.When viewing the Manage Owners page, you will see a "pending approval" entry in the current owners. Esse convite pode ser removido, da mesma forma que outros proprietários podem ser removidos.That invitation can be removed; just as other owners can be removed. Esse processo de convites impede que os usuários adicionem outros usuários erroneamente como proprietários de seus itens.This process of invitations prevents users from falsely adding other users as owners of their items.

Observe que os metadados de “Autores” são meramente texto de forma livre; somente “Proprietários” são controlados.Note that the "Authors" metadata is purely freeform text; only "Owners" are controlled.

Removendo proprietáriosRemoving Owners

Quando um item tem vários proprietários e um deles precisa ser removido, o processo é simples:When an item has multiple owners and one needs to be removed, the process is simple:

  1. Faça logon na Galeria do PowerShell com a conta que é o proprietário atual de um item;Log on to PowerShell Gallery with the account that is the current owner of an item;
  2. Navegue até uma página de item usando a guia Itens, pesquisando ou clicando em seu nome de usuário e em Gerenciar Meus Itens.Navigate to an item page using the Items tab, searching, or clicking your username and then Manage My Items.
  3. Quando estiver conectado como o proprietário de um item, você verá um link “Gerenciar proprietários” do lado esquerdo para clicar;When logged on as an item's owner, there is a 'Manage Owners' link on the left side to click;
  4. Clique no link “Remover” ao lado do proprietário a ser removido.Click the 'remove' link next to the owner to be removed.

Transferindo a propriedade do itemTransferring Item Ownership

Às vezes, recebemos solicitações de suporte para transferir a propriedade do item de um usuário para outro, mas quase sempre você pode fazer isso sozinho.We sometimes get support requests to transfer item ownership from one user to another, but you can almost always accomplish this yourself. Transferir a propriedade de um usuário para outro é simplesmente uma combinação dos dois recursos acima.Transferring ownership from one user to another is simply a combination of the two features above.

  1. O proprietário atual convida o novo usuário para se tornar um coproprietário e o novo usuário aceita o convite;The current owner invites the new user to become a co-owner and the new user accepts the invite;
  2. O novo usuário remove o usuário antigo da lista de proprietários.The new user removes the old user from the list of owners.

Essa solicitação chegou de diversas maneiras, mas o processo funciona da mesma forma.This request has come in under a couple forms but the process works the same.

  • A propriedade do item muda de um desenvolvedor para outroThe item ownership is changing from one developer to another
  • O item foi publicado acidentalmente usando a conta erradaThe item was accidentally published using the wrong account

Itens órfãosOrphaned Items

Um último cenário ocorreu, mas não com muita frequência.One last scenario has occurred, but not many times. Alguns itens se tornaram órfãos e a única conta de proprietário do item não pode ser usada para adicionar novos proprietários.Items have become orphans and the only item owner account cannot be used to add new owners. Estes são alguns exemplos desse cenário:Here are some examples of this scenario:

  • A conta do proprietário é associada a um endereço de email que não existe mais, e o usuário esqueceu a senhaThe owner's account is associated with an email address that no longer exists and the user has forgotten their password
  • O proprietário registrado saiu da empresa que produz o item e não pode ser contatado para atualizar a propriedade do itemThe registered owner has left the company that produces the item and cannot be reached to update the item ownership
  • Devido a um bug que afetou apenas alguns dos itens, de alguma forma, não há proprietário para o item na galeriaDue to a bug that has only affected a handful of items, the item is somehow ownerless on the gallery

Os administradores da Galeria do PowerShell podem acessar o link “Gerenciar proprietários” de qualquer item.The PowerShell Gallery Administrators can access the 'Manage Owners' link for any item. Se você for o proprietário legítimo de um item e não conseguir acessar o proprietário atual para obter permissões de propriedade, use o link “Relatar abuso” na galeria para entrar em contato com os Administradores da Galeria do PowerShell.If you are the rightful owner of a item and cannot reach the current owner to gain ownership permissions, then use the 'Report Abuse' link on the gallery to reach the PowerShell Gallery Administrators. Em seguida, vamos seguir um processo para verificar sua propriedade do item.We will then follow a process to verify your ownership of the item. Se determinarmos que você deve ser o proprietário do item, nós mesmos usaremos o link “Gerenciar proprietários” do item e lhe enviaremos o convite para que você se torne um proprietário.If we determine you should be an owner of the item, we will use the 'Manage Owners' link for the item ourselves and send you the invite to become an owner. Podemos fazer isso apenas depois de verificar que você deve ser um proprietário e o processo para essa verificação varia de acordo com as circunstâncias.We will only do this after verifying that you should be an owner and the process for this varies by circumstances. Muitas vezes, usaremos a URL do Projeto do item para encontrar uma maneira de entrar em contato com o proprietário do projeto, mas também podemos usar o Twitter, email ou outros meios para entrar em contato com o proprietário do projeto.Often times, we will use the item's Project URL to find a way to contact the project owner, but we may also use Twitter, Email, or other means for contacting the project owner.