New-RoleGroup
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e definições podem ser exclusivos de um ambiente ou outro.
Use o cmdlet New-RoleGroup para criar grupos de função de gerenciamento.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
CrossForest
New-RoleGroup
[-Name] <String>
-LinkedDomainController <String>
-LinkedForeignGroup <UniversalSecurityGroupIdParameter>
[-LinkedCredential <PSCredential>]
[-Confirm]
[-CustomConfigWriteScope <ManagementScopeIdParameter>]
[-CustomRecipientWriteScope <ManagementScopeIdParameter>]
[-Description <String>]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-Force]
[-ManagedBy <MultiValuedProperty>]
[-Members <MultiValuedProperty>]
[-RecipientOrganizationalUnitScope <OrganizationalUnitIdParameter>]
[-Roles <RoleIdParameter[]>]
[-SamAccountName <String>]
[-WellKnownObject <String>]
[-WhatIf]
[<CommonParameters>]
Default
New-RoleGroup
[-Name] <String>
[-Confirm]
[-CustomConfigWriteScope <ManagementScopeIdParameter>]
[-CustomRecipientWriteScope <ManagementScopeIdParameter>]
[-Description <String>]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-Force]
[-Id <Guid>]
[-ManagedBy <MultiValuedProperty>]
[-Members <MultiValuedProperty>]
[-RecipientOrganizationalUnitScope <OrganizationalUnitIdParameter>]
[-Roles <RoleIdParameter[]>]
[-SamAccountName <String>]
[-WhatIf]
[<CommonParameters>]
Description
Não é necessário adicionar membros ou associar funções de gerenciamento ao grupo de função ao criá-lo. No entanto, até que membros sejam adicionados ou funções sejam associadas ao grupo de função, o grupo de função não concede permissões aos usuários. Também é possível especificar configurações personalizadas ou escopos de destinatários ao criar um grupo de função. Estes escopos são aplicados às atribuições de função de gerenciamento criadas quando o grupo de função é criado.
Ao criar um grupo de função, é possível criar o grupo e adicionar membros diretamente, ou criar um grupo de função vinculado. Um grupo de função vincula o grupo de função a um grupo de segurança universal (USG) em outra floresta. A criação de um grupo de funções ligadas é útil se os servidores que executam o Exchange residirem numa floresta de recursos e os seus utilizadores e administradores residirem numa floresta de utilizadores separada. Se um grupo de função vinculado for criado, não será possível adicionar membros diretamente a ele. Você deve adicionar os membros ao USG na floresta externa.
Para saber mais sobre grupos de função, confira o artigo Noções básicas sobre grupos de funções de gerenciamento.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
New-RoleGroup -Name "Limited Recipient Management" -Roles "Mail Recipients", "Mail Enabled Public Folders" -Members Kim, Martin
Este exemplo cria um grupo de função. As funções Destinatários de Email (Mail Recipients) e Pastas Públicas Habilitadas para Email (Mail Enabled Public Folders) são atribuídas ao grupo de função, e os usuários Kim e Martin são adicionados como membros. Como nenhum escopo foi fornecido, Kim e Martin podem gerenciar qualquer destinatário e redefinir senhas para qualquer usuário na organização.
Exemplo 2
New-RoleGroup -Name "Seattle Limited Recipient Management" -Roles "Mail Recipients", "Mail Enabled Public Folders" -Members John, Carol -CustomRecipientWriteScope "Seattle Recipients"
Este exemplo cria um grupo de função com um escopo de destinatário personalizado. O escopo de destinatário personalizado, Seattle Recipients, limita o escopo das funções atribuídas ao grupo de função para destinatários que têm a propriedade City definida como Seattle. As funções Destinatários de Email (Mail Recipients) e Pastas Públicas Habilitadas para Email (Mail Enabled Public Folders) são atribuídas ao grupo de função, e os usuários John e Carol são adicionados como membros.
Exemplo 3
New-RoleGroup -Name "Transport Rules Management" -Roles "Transport Rules" -Members "Compliance Group" -ManagedBy Isabel
Este exemplo cria um grupo de função e habilita Isabel a adicionar ou remover membros do grupo de função, adicionando-a à propriedade ManagedBy. A função Regras de Transporte está atribuída ao grupo de função e o USG Grupo de Conformidade (Compliance Group) está adicionado como membro.
Exemplo 4
$Credentials = Get-Credential
New-RoleGroup -Name "ContosoUsers: Toronto Recipient Admins" -LinkedDomainController dc02.contosousers.contoso.com -LinkedCredential $Credentials -LinkedForeignGroup "Toronto Administrators" -CustomRecipientWriteScope "Toronto Recipients" -Roles "Mail Recipients"
Este exemplo cria um grupo de função vinculado que habilita os membros do USG Toronto Administrators na floresta do usuário Contoso a gerenciar destinatários localizados no escritório de Toronto. O escopo de destinatário personalizado, Toronto Recipients, limita o escopo das funções atribuídas ao grupo de função para destinatários que têm a propriedade City definida como Toronto. A função Destinatários de Email (Mail Recipients) é atribuída ao grupo de função.
O primeiro comando obtém as credenciais com o cmdlet Get-Credential e armazena-as na variável $Credentials. Em seguida, o grupo de funções ligado é criado com o segundo comando.
Exemplo 5
$RoleGroup = Get-RoleGroup "Recipient Management"
New-RoleGroup "Limited Recipient Management" -Roles $RoleGroup.Roles
Este exemplo usa um grupo de função existente e copia suas funções para um novo grupo de função personalizado. Isso pode ser útil se você deseja criar um grupo de função similar a um grupo existente mas não deseja criar todas as atribuições de função manualmente. Por exemplo, talvez você queira criar um grupo de função que tenha a maioria das, mas não todas as, funções de gerenciamento associadas ao grupo de função Gerenciamento de Destinatário.
O primeiro comando armazena o grupo de funções existente numa variável e o segundo comando cria o grupo de funções personalizado.
Este exemplo usa variáveis para armazenar informações. Para obter mais informações sobre variáveis, veja About Variables (Acerca das Variáveis).
Exemplo 6
Remove-ManagementRoleAssignment "Distribution Groups-Limited Recipient Management"
Este exemplo remove a atribuição de função entre a função de gestão Grupos de Distribuição e o grupo de funções Gestão limitada de Destinatários que criou no exemplo anterior.
Parâmetros
-Confirm
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformidade & de Segurança, Segurança incorporada suplemento para caixas de correio no local
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-CustomConfigWriteScope
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro CustomConfigWriteScope especifica o escopo de gerenciamento com base na configuração existente a ser associado às atribuições da função de gerenciamento criadas com este grupo de função. Se o nome do escopo de gerenciamento contiver espaços, coloque-o entre aspas ("). Use o cmdlet Get-ManagementScope para recuperar uma lista de escopos de gerenciamento existentes.
Propriedades do parâmetro
| Tipo: | ManagementScopeIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-CustomRecipientWriteScope
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Suplemento de segurança incorporado para no local caixas de correio
O parâmetro CustomRecipientWriteScope especifica o escopo de gerenciamento com base no destinatário existente a ser associado às atribuições da função de gerenciamento criadas com este grupo de função. Se o nome do escopo de gerenciamento contiver espaços, coloque-o entre aspas (").
Use o cmdlet Get-ManagementScope para recuperar uma lista de escopos de gerenciamento existentes.
Se o parâmetro CustomRecipientWriteScope for utilizado, não é possível usar o parâmetro RecipientOrganizationalUnitScope.
Propriedades do parâmetro
| Tipo: | ManagementScopeIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Description
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformidade & de Segurança, Segurança incorporada suplemento para caixas de correio no local
O parâmetro Description especifica a descrição exibida quando o grupo de função for visualizado usando o cmdlet Get-RoleGroup. Coloque a descrição entre aspas (").
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DisplayName
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformidade & de Segurança, Segurança incorporada suplemento para caixas de correio no local
O parâmetro DisplayName especifica o nome amigável do grupo de função. Se o nome contiver espaços, coloque-o entre aspas ("). Este parâmetro tem um comprimento máximo de 256 carateres.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Force
Aplicável: Exchange Online, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local
Esse parâmetro só está disponível no serviço baseado em nuvem.
O comutador Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.
Você pode usar essa opção para executar tarefas de modo programático onde a solicitação por entrada administrativa é inadequada.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Id
Aplicável: Conformidade do & de Segurança
Este parâmetro só está disponível no PowerShell de Conformidade do & de Segurança.
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | Guid |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Default
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-LinkedCredential
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro LinkedCredential especifica o nome de utilizador e a palavra-passe utilizados para aceder ao controlador de domínio especificado pelo parâmetro LinkedDomainController.
Um valor para esse parâmetro requer o cmdlet Get-Credential. Para pausar o comando e receber uma solicitação de credenciais, use o valor (Get-Credential). Ou, antes de executar esse comando, armazene as credenciais em uma variável (por exemplo, $cred = Get-Credential) e, em seguida, use o nome da variável ($cred) para esse parâmetro. Para saber mais, confira Obter credencial.
Propriedades do parâmetro
| Tipo: | PSCredential |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
CrossForest
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-LinkedDomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro LinkedDomainController especifica o nome de domínio totalmente qualificado (FQDN) ou endereço IP do controlador de domínio na floresta onde o USG externo reside. O controlador de domínio especificado é usado para obter informações de segurança para o USG externo especificado pelo parâmetro LinkedForeignGroup.
Se utilizar o parâmetro LinkedDomainController, tem de especificar um USG estrangeiro com o parâmetro LinkedForeignGroup e não pode utilizar o parâmetro Members.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
CrossForest
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-LinkedForeignGroup
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro LinkedForeignGroup especifica o nome do USG externo a ser vinculado a este grupo de função. Se o nome do USG externo contiver espaços, coloque-o entre aspas (").
Se utilizar o parâmetro LinkedForeignGroup, tem de especificar um controlador de domínio no parâmetro LinkedDomainController e não pode utilizar o parâmetro Members.
Propriedades do parâmetro
| Tipo: | UniversalSecurityGroupIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
CrossForest
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ManagedBy
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Suplemento de segurança incorporado para no local caixas de correio
O parâmetro ManagedBy especifica os usuários ou USGs que podem modificar a configuração de um grupo de função ou adicionar e remover membros de um grupo de função.
Você pode usar o nome, nome diferenciado (DN) ou endereço SMTP principal do usuário ou USG que deseja adicionar. Se o nome do usuário ou USG contiver espaços, coloque-o entre aspas (").
Se quiser adicionar mais de um usuário ou USG, separe-os por vírgulas.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Members
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformidade & de Segurança, Segurança incorporada suplemento para caixas de correio no local
O parâmetro Members especifica as caixas de correio ou os USGs com capacidade de correio para adicionar como membro do grupo de funções. Pode identificar o utilizador ou grupo pelo nome, DN ou valor de endereço SMTP principal. Pode especificar vários membros separados por vírgulas (Value1,Value2,...ValueN). Se o valor contiver espaços, coloque o valor entre aspas ("Value 1","Value 2",..."Value N").
Se utilizar o parâmetro Membros, não poderá utilizar os parâmetros LinkedForeignGroup, LinkedDomainController ou LinkedCredential.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformidade & de Segurança, Segurança incorporada suplemento para caixas de correio no local
O parâmetro Name especifica o nome do novo grupo de função. O nome pode ter até 64 caracteres. Se o nome contiver espaços, coloque-o entre aspas (").
Nota: se criar um grupo de funções ligado, recomendamos que inclua o nome da floresta externa no nome do grupo de funções para que possa associar mais facilmente o grupo de funções ligado e a floresta externa associada. Isso é especialmente importante se você tiver várias florestas.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RecipientOrganizationalUnitScope
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro RecipientOrganizationalUnitScope especifica o escopo da UO (unidade organizacional) adicionada às atribuições da função criadas quando o grupo de função é criado. Se o parâmetro RecipientOrganizationalUnitScope for utilizado, não é possível usar o parâmetro CustomRecipientWriteScope. Para especificar uma OU, use a sintaxe: domínio/ou. Se o nome da OU contiver espaços, coloque o domínio e a OU entre aspas (").
Propriedades do parâmetro
| Tipo: | OrganizationalUnitIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Roles
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformidade & de Segurança, Segurança incorporada suplemento para caixas de correio no local
O parâmetro Roles especifica as funções de gerenciamento a atribuir ao grupo de função quando é criado. Se o nome da função contiver espaços, coloque-o entre aspas ("). Se desejar atribuir mais de uma função, separe os nomes de função por vírgulas.
Para obter uma lista das funções de gestão incorporadas que pode atribuir a um grupo de funções, veja Funções de gestão incorporadas.
Propriedades do parâmetro
| Tipo: | RoleIdParameter[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SamAccountName
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro SamAccountName (também conhecido como a conta de utilizador ou nome de grupo anterior ao Windows 2000) especifica um identificador de objeto compatível com versões mais antigas dos sistemas operativos de servidor e cliente do Microsoft Windows. O valor pode conter letras, números, espaços, pontos finais (.) e os seguintes carateres: !, #, $, %, ^, &, -, _, {, }e ~. O último caráter não pode ser um ponto final. Os carateres Unicode são permitidos, mas os carateres acentuados podem gerar colisões (por exemplo, o e ö correspondem). O comprimento máximo é de 20 carateres.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WellKnownObject
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
Esse parâmetro só está disponível no serviço baseado em nuvem.
{{ Fill WellKnownObject Description }}
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Default
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformidade & de Segurança, Segurança incorporada suplemento para caixas de correio no local
A opção WhatIf não funciona no PowerShell de Segurança e Conformidade.
A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.