CSP eUICCs

Artigo
02/06/2024

O provedor de serviços de configuração de eUICCs é usado para dar suporte a casos de uso corporativo do eUICC e permite que o administrador de TI gerencie assinaturas (atribuir, reatribuir, remover) aos funcionários.

A lista a seguir mostra os nós do provedor de serviços de configuração de eUICCs:

./Device/Vendor/MSFT/eUICCs
- {eUICC}
  - Ações
    - ResetToFactoryState
    - Status
  - DownloadServers
    - {ServerName}
  - Identificador
  - IsActive
  - Políticas
    - LocalUIEnabled
  - PPR1Allowed
  - PPR1AlreadySet
  - Perfis
    - {ICCID}
      - ErrorDetail
      - IsEnabled
      - MatchingID
      - PPR1Set
      - PPR2Set
      - ServerName
      - Estado

{eUICC}

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 10, versão 1709 [10.0.16299] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}

Representa informações associadas a um eUICC. Há uma sub-árvore para cada eUICC conhecido, criada pelo Assistente de Perfil Local (LPA) quando o eUICC é visto pela primeira vez. O nome do nó é a EID (ID do eUICC). O nome do nó "Default" representa o eUICC atualmente ativo.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Obter
Nomenclatura de nó dinâmico	UniqueName: A ID eUICC (EID) associada ao dispositivo.

{eUICC}/Actions

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 10, versão 1709 [10.0.16299] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/Actions

Ações que podem ser executadas no eUICC como um todo.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Obter

{eUICC}/Actions/ResetToFactoryState

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 10, versão 1709 [10.0.16299] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/Actions/ResetToFactoryState

Isso dispara uma redefinição de memória eUICC, que apaga todos os perfis eSIM no eUICC.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`chr` (cadeia de caracteres)
Tipo de acesso	Exec

{eUICC}/Actions/Status

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 10, versão 1709 [10.0.16299] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/Actions/Status

Status da operação mais recente, como um HRESULT. S_OK indica êxito, S_FALSE indica que a operação está em andamento, outros valores representam erros específicos.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`int`
Tipo de acesso	Obter
Valor Padrão	0

{eUICC}/DownloadServers

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 11, versão 21H2 [10.0.22000] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/DownloadServers

Representa servidores usados para provisionamento em massa e descoberta de eSIM.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Obter

{eUICC}/DownloadServers/{ServerName}

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 11, versão 21H2 [10.0.22000] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/DownloadServers/{ServerName}

Nó que representa um servidor de download/descoberta em massa. O nome do nó é o nome de domínio totalmente qualificado do servidor que será usado. A criação dessa sub-árvore dispara uma solicitação de descoberta.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Adicionar, Excluir, Obter, Substituir
Nomenclatura de nó dinâmico	UniqueName: ServerName usado para a operação de descoberta.

{eUICC}/DownloadServers/{ServerName}/AutoEnable

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 11, versão 21H2 [10.0.22000] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/DownloadServers/{ServerName}/AutoEnable

Indica se o perfil descoberto deve ser habilitado automaticamente após a instalação. Isso deve ser definido pelo MDM quando a sub-árvore ServerName for criada.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`bool`
Tipo de acesso	Adicionar, Obter, Substituir

Valores Permitidos:

Valor	Descrição
false	Desabilitar.
true	Habilitar.

{eUICC}/DownloadServers/{ServerName}/DiscoveryState

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 11, versão 21H2 [10.0.22000] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/DownloadServers/{ServerName}/DiscoveryState

Estado atual da operação de descoberta para este servidor (Solicitado = 1, Execução = 2, Concluído = 3, Falha = 4).

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`int`
Tipo de acesso	Obter
Valor Padrão	1

{eUICC}/DownloadServers/{ServerName}/IsDiscoveryServer

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 11, versão 22H2 [10.0.22621] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/DownloadServers/{ServerName}/IsDiscoveryServer

Indica se o servidor é um servidor de descoberta ou se ele é usado para download em massa. Um servidor de descoberta é usado sempre que um usuário solicita uma operação de descoberta de perfil. Opcional, o valor padrão é falso.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`bool`
Tipo de acesso	Adicionar, Obter, Substituir
Valor Padrão	false

Valores Permitidos:

Valor	Descrição
false (Padrão)	Não é o Servidor de Descoberta.
true	É o Discovery Server.

{eUICC}/Identificador

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 10, versão 1709 [10.0.16299] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/Identifier

O identificador eUICC exclusivo (EID).

Identifica um eUICC de maneira específica da implementação, por exemplo, essa identificação pode ser um hash SHA-256 do EID.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`chr` (cadeia de caracteres)
Tipo de acesso	Obter

{eUICC}/IsActive

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 10, versão 1709 [10.0.16299] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/IsActive

Indica se esse eUICC está fisicamente presente e ativo. Atualizado apenas pela LPA.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`bool`
Tipo de acesso	Obter

{eUICC}/Policies

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 10, versão 1709 [10.0.16299] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/Policies

Políticas de dispositivo associadas ao eUICC como um todo (não por perfil).

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Obter

{eUICC}/Policies/LocalUIEnabled

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 10, versão 1709 [10.0.16299] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/Policies/LocalUIEnabled

Determina se o usuário pode ou não fazer alterações no eSIM por meio da interface do usuário.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`bool`
Tipo de acesso	Obter, Substituir
Valor Padrão	true

Valores Permitidos:

Valor	Descrição
false	Desabilitado.
true (Padrão)	Enabled.

{eUICC}/PPR1Allowed

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 10, versão 1709 [10.0.16299] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/PPR1Allowed

Indica se o download de um perfil com a Regra de Política de Perfil 1 (PPR1) é permitido. Se o eUICC já tiver um perfil (independentemente de sua origem e regras de política associadas a ele), o download de um perfil com PPR1 não será permitido.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`bool`
Tipo de acesso	Obter

{eUICC}/PPR1AlreadySet

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 10, versão 1709 [10.0.16299] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/PPR1AlreadySet

Indica se o eUICC já tem um perfil com a Regra de Política de Perfil 1 (PPR1).

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`bool`
Tipo de acesso	Obter

{eUICC}/Perfis

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 10, versão 1709 [10.0.16299] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/Profiles

Representa todos os perfis eSIM de propriedade da empresa.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Obter

{eUICC}/Profiles/{ICCID}

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 10, versão 1709 [10.0.16299] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/Profiles/{ICCID}

Nó que representa um perfil eSIM de propriedade empresarial. O nome do nó é o ICCID do perfil (que é um identificador exclusivo). A criação dessa sub-árvore dispara uma solicitação AddProfile pela LPA (que instala o perfil no eUICC). A remoção dessa sub-árvore dispara o LPA para excluir o perfil (se residente no eUICC).

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Adicionar, Excluir, Obter, Substituir
Nomenclatura de nó dinâmico	UniqueName: ICCID do perfil.

{eUICC}/Profiles/{ICCID}/ErrorDetail

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 10, versão 1709 [10.0.16299] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/Profiles/{ICCID}/ErrorDetail

Erro detalhado se o procedimento de download e instalação do perfil falhar (Nenhum = 0, CardGeneralFailure = 1, ConfirmationCodeMissing = 3, ForbiddenByPolicy = 5, InvalidMatchingId = 6, NoEligibleProfileForThisDevice = 7, NotEnoughSpaceOnCard = 8, ProfileEidMismatch = 10, ProfileNotAvailableForNewBinding = 11, ProfileNotReleasedByOperator = 12, RemoteServerGeneralFailure = 13, RemoteServerUnreachable = 14).

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`int`
Tipo de acesso	Obter
Valor Padrão	0

{eUICC}/Profiles/{ICCID}/IsEnabled

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 10, versão 1803 [10.0.17134] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/Profiles/{ICCID}/IsEnabled

Indica se esse perfil eSIM está habilitado. Pode ser definido pelo MDM e pelo CSP.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`bool`
Tipo de acesso	Adicionar, Obter, Substituir

Valores Permitidos:

Valor	Descrição
false	Desabilitado.
true	Enabled.

{eUICC}/Profiles/{ICCID}/MatchingID

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 10, versão 1709 [10.0.16299] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/Profiles/{ICCID}/MatchingID

ID correspondente (token de código de ativação) para download de perfil eSIM. Deve ser definido pelo MDM quando a sub-árvore ICCID for criada.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`chr` (cadeia de caracteres)
Tipo de acesso	Adicionar, Obter, Substituir
Valores Permitidos	Expressão regular: `^([0-9a-fA-F]{5}-){3}[0-9a-fA-F]{5}$`

{eUICC}/Profiles/{ICCID}/PPR1Set

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 10, versão 1709 [10.0.16299] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/Profiles/{ICCID}/PPR1Set

A Regra 1 da Política de Perfil (PPR1) indica se a desabilitação desse perfil não é permitida (true, se não permitido, false caso contrário).

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`bool`
Tipo de acesso	Obter

{eUICC}/Profiles/{ICCID}/PPR2Set

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 10, versão 1709 [10.0.16299] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/Profiles/{ICCID}/PPR2Set

A Regra 2 da Política de Perfil (PPR2) indica se a exclusão desse perfil não é permitida (true, se não permitido, false caso contrário).

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`bool`
Tipo de acesso	Obter

{eUICC}/Profiles/{ICCID}/ServerName

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 10, versão 1709 [10.0.16299] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/Profiles/{ICCID}/ServerName

Nome de domínio totalmente qualificado do servidor que pode baixar esse perfil eSIM. Deve ser definido pelo MDM quando a sub-árvore ICCID for criada.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`chr` (cadeia de caracteres)
Tipo de acesso	Adicionar, Obter, Substituir

{eUICC}/Profiles/{ICCID}/State

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows 10, versão 1709 [10.0.16299] e posterior

./Device/Vendor/MSFT/eUICCs/{eUICC}/Profiles/{ICCID}/State

Estado atual do perfil eSIM (Instalação = 1, Instalado = 2, Exclusão = 3, Erro = 4).

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`int`
Tipo de acesso	Obter
Valor Padrão	1

Referência de provedor de serviços de configuração

Compartilhar via

CSP eUICCs

{eUICC}

{eUICC}/Actions

{eUICC}/Actions/ResetToFactoryState

{eUICC}/Actions/Status

{eUICC}/DownloadServers

{eUICC}/DownloadServers/{ServerName}

{eUICC}/DownloadServers/{ServerName}/AutoEnable

{eUICC}/DownloadServers/{ServerName}/DiscoveryState

{eUICC}/DownloadServers/{ServerName}/IsDiscoveryServer

{eUICC}/Identificador

{eUICC}/IsActive

{eUICC}/Policies

{eUICC}/Policies/LocalUIEnabled

{eUICC}/PPR1Allowed

{eUICC}/PPR1AlreadySet

{eUICC}/Perfis

{eUICC}/Profiles/{ICCID}

{eUICC}/Profiles/{ICCID}/ErrorDetail

{eUICC}/Profiles/{ICCID}/IsEnabled

{eUICC}/Profiles/{ICCID}/MatchingID

{eUICC}/Profiles/{ICCID}/PPR1Set

{eUICC}/Profiles/{ICCID}/PPR2Set

{eUICC}/Profiles/{ICCID}/ServerName

{eUICC}/Profiles/{ICCID}/State

Comentários

Recursos adicionais

Compartilhar via

CSP eUICCs

{eUICC}

{eUICC}/Actions

{eUICC}/Actions/ResetToFactoryState

{eUICC}/Actions/Status

{eUICC}/DownloadServers

{eUICC}/DownloadServers/{ServerName}

{eUICC}/DownloadServers/{ServerName}/AutoEnable

{eUICC}/DownloadServers/{ServerName}/DiscoveryState

{eUICC}/DownloadServers/{ServerName}/IsDiscoveryServer

{eUICC}/Identificador

{eUICC}/IsActive

{eUICC}/Policies

{eUICC}/Policies/LocalUIEnabled

{eUICC}/PPR1Allowed

{eUICC}/PPR1AlreadySet

{eUICC}/Perfis

{eUICC}/Profiles/{ICCID}

{eUICC}/Profiles/{ICCID}/ErrorDetail

{eUICC}/Profiles/{ICCID}/IsEnabled

{eUICC}/Profiles/{ICCID}/MatchingID

{eUICC}/Profiles/{ICCID}/PPR1Set

{eUICC}/Profiles/{ICCID}/PPR2Set

{eUICC}/Profiles/{ICCID}/ServerName

{eUICC}/Profiles/{ICCID}/State

Artigos relacionados

Comentários

Recursos adicionais