Partilhar via

Update-SCOMRunAsAccount

  • Referência
Módulo:
OperationsManager

Atualizações as credenciais de uma conta Run As 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 Run As do System Center – Operations Manager. Uma conta Run As dá aos utilizadores a capacidade de especificar as permissões necessárias para utilização com regras, tarefas, monitores e deteções direcionadas para computadores específicos, conforme necessário.

Este cmdlet não suporta contas SCX (multiplataforma) nem contas do Protocolo de Gestão de Rede Simples versão 3 (SNMPv3). Em vez disso, utilize Get-SCOMRunAsAccount para atualizar contas SCX.

Exemplos

Exemplo 1: Atualizar uma conta Run As do Windows

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

Este exemplo atualiza uma conta Run As do Windows.

O primeiro comando obtém o objeto de conta Run As com o nome Domain Administração e armazena o objeto na variável $WindowsAccount.

O segundo comando transmite a conta Run As armazenada na variável $WindowsAccount para o cmdlet Update-SCOMRunAsAccount com o operador de pipeline. Esse cmdlet atualiza as credenciais da conta para o nome de utilizador e palavra-passe que o utilizador fornece ao responder ao pedido do cmdlet Get-Credential .

Exemplo 2: Atualizar uma conta Run As 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 Run As de ação.

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

O segundo comando pede ao utilizador para introduzir uma cadeia que representa a palavra-passe. Em seguida, armazena a entrada do utilizador como uma cadeia segura na variável $Password.

O terceiro comando cria um objeto PSCredential com o nome armazenado na variável $UserName e a palavra-passe armazenada no $Password. Em seguida, armazena o objeto PSCredential na variável $NewCred.

O último comando obtém a conta de ação denominada Conta de Ação do SCOM. Em seguida, utiliza o operador de pipeline para transmitir 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 Comunidade

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

Este comando atualiza as credenciais de uma conta Run As que utiliza a autenticação de cadeia de comunidade para a versão 2 do SNMP. Obtém a conta de cadeia de comunidade denominada MyCommunityStringAccount e utiliza o operador de pipeline para transmitir a conta para o cmdlet Update-SCOMRunAsAccount . Este cmdlet atualiza a cadeia de comunidade com o valor que o utilizador introduz em resposta aos pedidos do cmdlet Read-Host . Para mais informações, insira 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 com o nome MyBinaryAccount e utiliza o operador de pipeline para transmitir o objeto para o cmdlet Update-SCOMRunAsAccount . Este cmdlet utiliza o parâmetro Path para indicar que obtém os novos dados de conta do ficheiro com o nome data.txt.

Parâmetros

-AccountType

Especifica o tipo da conta Run As. Normalmente, o pipeline preenche este 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 Run As.

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

-BasicAccount

Especifica uma conta Run As que utiliza 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 Run As que utiliza 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 comunidade para uma conta Run As SNMP versão 2 que utiliza a autenticação de cadeia de comunidade.

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

-CommunityStringAccount

Especifica uma conta Run As da versão 2 do SNMP que utiliza a autenticação de cadeia de 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 ligações temporárias com grupos de gestão para estes computadores. Pode utilizar nomes NetBIOS, endereços IP ou nomes de domínio completamente qualificados (FQDNs). Para especificar o computador local, escreva o nome do computador, localhost ou um ponto (.).

O serviço de Acesso a Dados do System Center tem de ser iniciado no computador. Se não especificar um computador, o cmdlet utiliza o computador para a ligação do grupo de gestão atual.

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

-Confirm

Solicita a 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 utilizador na qual a ligação do grupo de gestão é executada. Especifique um objeto PSCredential , como um que o cmdlet Get-Credential devolve, para este parâmetro. Para obter mais informações sobre objetos de credenciais, escreva Get-Help Get-Credential.

Se especificar um computador no parâmetro ComputerName , utilize uma conta que tenha acesso a esse computador. A predefinição é o utilizador atual.

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

-DigestAccount

Especifica uma conta Run As que utiliza a autenticação 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 utilizar no pipeline. Por predefinição, este cmdlet não gera quaisquer dados.

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

-Path

Especifica o caminho para um ficheiro que contém novos dados de credenciais para contas Run As que utilizam 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 utilizam um nome de utilizador e palavra-passe.

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

-SCSession

Especifica uma matriz de objetos de Ligação . Para obter objetos de Ligação , utilize o cmdlet Get-SCOMManagementGroupConnection .

Se este parâmetro não for especificado, o cmdlet utiliza a ligação persistente ativa a um grupo de gestão. Utilize o parâmetro SCSession para especificar uma ligação persistente diferente. Pode criar uma ligação temporária a um grupo de gestão com os parâmetros ComputerName e Credential . Para mais informações, insira 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 Run As que utiliza autenticação Web simples.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. 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 Run As que utiliza a autenticação do Windows.

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