Detectar se o PowerShell está sendo executado como administrador

Como posso saber nos meus scripts se o PowerShell está sendo executado com privilégios de administrador?

Preciso saber porque estou tentando executar um programa que requer a capacidade de abrir portas protegidas.

[bool](([System.Security.Principal.WindowsIdentity]::GetCurrent()).groups -match "S-1-5-32-544")

Desmembrando o que isso faz:

• [bool]- Lance o resultado final para a bool.
• [System.Security.Principal.WindowsIdentity]::GetCurrent()- Recupera WindowsIdentitypara o usuário em execução no momento.
• (...).groups- Acesse a groupspropriedade da identidade para descobrir em quais grupos de usuários a identidade é membro.
• -match "S-1-5-32-544"verifica se groupscontém o SID conhecido do grupo Administradores, a identidade só o conterá se "executar como administrador" for usado.

([Security.Principal.WindowsPrincipal] `
  [Security.Principal.WindowsIdentity]::GetCurrent() `
).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)

Isso recupera a identidade atual do Windows e retorna True se a identidade atual tiver a função Administrador (ou seja, estiver executando elevada).

No Powershell 4.0, você pode usar os requisitos na parte superior do seu script:

#Requires -RunAsAdministrator

Saídas:

O script 'MyScript.ps1' não pode ser executado porque contém uma instrução "#requires" para ser executada como Administrador. A sessão atual do Windows PowerShell não está sendo executada como administrador. Inicie o Windows PowerShell usando a opção Executar como administrador e tente executar o script novamente.