Compartilhar via

Update-SCOMRunAsAccount

  • Referência
Módulo:
OperationsManager

Atualizações as credenciais de uma conta Executar como do Operations Manager.

Syntax

Update-SCOMRunAsAccount
      [-WindowsAccount] <WindowsCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-BasicAccount] <BasicCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-SimpleAccount] <SimpleCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-DigestAccount] <DigestCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-ActionAccount] <ActionAccountSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-CommunityStringAccount] <CommunityStringSecureData>
      [-CommunityString] <SecureString>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-BinaryAccount] <GenericSecureData>
      [-Path] <String>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Update-SCOMRunAsAccount atualiza as credenciais de uma conta Executar como do System Center – Operations Manager. Uma conta Executar como oferece aos usuários a capacidade de especificar as permissões necessárias para uso com regras, tarefas, monitores e descobertas direcionadas a computadores específicos conforme necessário.

Esse cmdlet não dá suporte a contas SCX (multiplataforma) nem contas SNMPv3 (Simple Network Management Protocol versão 3). Em vez disso, use Get-SCOMRunAsAccount para atualizar contas SCX.

Exemplos

Exemplo 1: Atualizar uma conta Executar como do Windows

PS C:\>$WindowsAccount = Get-SCOMRunAsAccount -Name "Domain Admin"
PS C:\>$WindowsAccount | Update-SCOMRunAsAccount -RunAsCredential (Get-Credential)

Este exemplo atualiza uma conta Executar como do Windows.

O primeiro comando obtém o objeto de conta Executar como chamado Administração de Domínio e armazena o objeto na variável $WindowsAccount.

O segundo comando passa a conta Executar como armazenada na variável $WindowsAccount para o cmdlet Update-SCOMRunAsAccount usando o operador de pipeline. Esse cmdlet atualiza as credenciais da conta para o nome de usuário e a senha que o usuário fornece respondendo ao prompt do cmdlet Get-Credential .

Exemplo 2: Atualizar uma conta Executar como de ação

PS C:\>$UserName = "Contoso\SCOMActionAccount"
PS C:\>$Password = Read-Host -AsSecureString
PS C:\>$NewCred = new-object System.Management.Automation.PsCredential $UserName,$Password
PS C:\>Get-SCOMRunAsAccount -Name "SCOM Action Account" | Update-SCOMRunAsAccount -RunAsCredential $newCred

Este exemplo atualiza as credenciais de uma conta Executar como da ação.

O primeiro comando cria uma cadeia de caracteres que contém um nome de conta de ação e armazena a cadeia de caracteres na variável $UserName.

O segundo comando solicita que o usuário insira uma cadeia de caracteres que represente a senha. Em seguida, ele armazena a entrada do usuário como uma cadeia de caracteres segura na variável $Password.

O terceiro comando cria um objeto PSCredential usando o nome armazenado na variável $UserName e a senha armazenada em $Password. Em seguida, ele armazena o objeto PSCredential na variável $NewCred.

O último comando obtém a conta de ação chamada Conta de Ação do SCOM. Em seguida, ele usa o operador de pipeline para passar a conta para o cmdlet Update-SCOMRunAsAccount , que atualiza a conta com as credenciais armazenadas na variável $NewCred.

Exemplo 3: Atualizar uma conta de cadeia de caracteres da comunidade

PS C:\>Get-SCOMRunAsAccount -Name "MyCommunityStringAccount" | Update-SCOMRunAsAccount -CommunityString (Read-Host -AsSecureString)

Esse comando atualiza as credenciais de uma conta Executar como que usa a autenticação de cadeia de caracteres da comunidade para SNMP versão 2. Ele obtém a conta de cadeia de caracteres da comunidade chamada MyCommunityStringAccount e usa o operador de pipeline para passar a conta para o cmdlet Update-SCOMRunAsAccount . Esse cmdlet atualiza a cadeia de caracteres da comunidade com o valor que o usuário insere em resposta aos prompts do cmdlet Read-Host . Para obter mais informações, digite Get-Help Read-Host.

Exemplo 4: Atualizar uma conta de Autenticação Binária

PS C:\>Get-SCOMRunAsAccount -Name "MyBinaryAccount" | Update-SCOMRunAsAccount -Path ".\data.txt"

Este exemplo obtém o objeto de conta binária chamado MyBinaryAccount e usa o operador de pipeline para passar o objeto para o cmdlet Update-SCOMRunAsAccount . Esse cmdlet usa o parâmetro Path para indicar que ele obtém os novos dados da conta do arquivo chamado data.txt.

Parâmetros

-AccountType

Especifica o tipo da conta Executar como. O pipeline normalmente preenche esse valor automaticamente.

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

-ActionAccount

Especifica uma conta de ação como uma conta Executar como.

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

-BasicAccount

Especifica uma conta Executar como que usa a Autenticação Básica.

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

-BinaryAccount

Especifica uma conta Executar como que usa a Autenticação Binária.

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

-CommunityString

Especifica a nova cadeia de caracteres da comunidade para uma conta Executar como do SNMP versão 2 que usa a autenticação de cadeia de caracteres da comunidade.

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

-CommunityStringAccount

Especifica uma conta Executar como do SNMP versão 2 que usa a autenticação de cadeia de caracteres da comunidade.

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

-ComputerName

Especifica uma matriz de nomes de computadores. O cmdlet estabelece conexões temporárias com grupos de gerenciamento para esses computadores. Você pode usar nomes NetBIOS, endereços IP ou FQDNs (nomes de domínio totalmente qualificados). Para especificar o computador local, digite o nome do computador, localhost ou um ponto (.).

O serviço de Acesso a Dados do System Center deve ser iniciado no computador. Se você não especificar um computador, o cmdlet usará o computador para a conexão do grupo de gerenciamento atual.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

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

-Credential

Especifica a conta de usuário na qual a conexão do grupo de gerenciamento é executada. Especifique um objeto PSCredential , como um que o cmdlet Get-Credential retorna, para esse parâmetro. Para obter mais informações sobre objetos de credencial, digite Get-Help Get-Credential.

Se você especificar um computador no parâmetro ComputerName , use uma conta que tenha acesso a esse computador. O padrão é o usuário atual.

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

-DigestAccount

Especifica uma conta Executar como que usa a autenticação da Web de resumo padrão.

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

-PassThru

Indica que o cmdlet cria ou modifica um objeto que um comando pode usar no pipeline. Por padrão, este cmdlet não gera saída.

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

-Path

Especifica o caminho para um arquivo que contém novos dados de credencial para contas Executar como que usam a Autenticação Binária.

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

-RunAsCredential

Especifica novas credenciais para tipos de conta que usam um nome de usuário e uma senha.

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

-SCSession

Especifica uma matriz de objetos Connection . Para obter objetos Connection , use o cmdlet Get-SCOMManagementGroupConnection .

Se esse parâmetro não for especificado, o cmdlet usará a conexão persistente ativa com um grupo de gerenciamento. Use o parâmetro SCSession para especificar uma conexão persistente diferente. Você pode criar uma conexão temporária com um grupo de gerenciamento usando os parâmetros ComputerName e Credential . Para obter mais informações, digite Get-Help about_OpsMgr_Connections.

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SimpleAccount

Especifica uma conta Executar como que usa autenticação web simples.

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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

-WindowsAccount

Especifica uma conta Executar como que usa autenticação do Windows.

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